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POP-15 SYSTEM SOFTWARE 


COURSE ABSTRACT 

This course is intended for programmers who wish t© 
acquire a working familiarity with P0P-1S Assembly 
Language programming and the Disk or Advanced Monitor 
Operating Systems and the services provided by their 
monitors and associated system software. A portion of 
course time is devoted to supervised laboratory sessions. 

PREREQUISITES 

A working knowledge of the material presented in the 
Introduction to Minicomputers course. 

COURSE OBJECTIVES 

Upon successful completion of this course, the student will 
be able to: 

® Write, run and modify assembly language pro¬ 
grams using the PDP-15 instruction set and the 
MACRO assembler syntax. 

® Interface programs to the Advanced or DOS 
S/O Monitor. 

• Interact with the system by means of keyboard 
commands, system program command strings 
and programmed monitor requests. 

COURSE OUTLINE 

I. Memory Organization; Memory and Addressing 
Modes 

II. PDP-15 Instruction Set 

A. Memory Reference Instructions 

B. Augmented Instruction Set 


III. MACRO Assembler Syntax 
SV. Tape and Fite Formats 

V. Interrupt Systems 

A. Program I rsterrupt Control (PI) 

B. Automatic Priority Interrupt (API) 

VI. System Programs 

A. EDIT, MACRO, UNKING LOADER, DDT 

B. PIP, PATCH. SGEN, UPDATE, CHAIN and 
EXECUTE 

VII. I/O 

A. I/O Monitor 

B. System Macros 

VIII. FORTRAN and MACRO Interface 

IX. Handler Format 

X. Interaction with the system via keyboard commands 
and programmed monitor requests. 

COURSE LENGTH 
10 days 
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WEEK 1 


MONDAY A a M„ 

A e Description of Course 
B® Block Diagram of PBP-15 
C@ Software Overview 
B e Memory Organization 

1® Addressing on the PBP-15 
2. Arithmetic on the PDP-15 
E @ Central Processor Organization 
Fo Introduction to the Instruction Set 

MONDAY P a M a 

G @ Memory Reference Instructions 
H. Operate Instructions 
I® EAE Instructions 
J® Introduction to MAGRO-15 

TUESDAY A s M a 

A® Review 

B @ Subroutines 

C® Sum Group of Examples 

B® Indexed Instructions 

E® Absolute vs© Relocatable Programs 

TUESDAY P m M a 

F• I/O Overview 

G® IOT Instructions and Dedicated I/O 
H @ Paper Tape Formats 

WEDNESDAY A a M. 

A s Console Description and Operation 
B e Operation of Disk Operating System 
C© Use of the Editor 


WEDNESDAY P a M» 

D e LAB 


iv 
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THURSDAY A 0 M e 

A® MACRO-15 (again) 

B® Program Interrupt Facility (PI) 

C® Automatic Priority Interrupt (API) 

THURSDAY P e M s 

BU LAB 

E e Program and Homework Review 
F. Quiz 1 

FRIDAY A e Mo 


A 9 Quiz 1 Review 

B® Overview of DOS Monitor 

0® File Formats and Directory Structure 

D 0 Overview of Monitor Supervised I/O 

FRIDAY PA 

E„ LAB 


WEEK II 





A 0 Programmed I/O Conmands 
l a Basic Operation 
2 0 System Macros 

3® DAT useage and Linking Loader 

4® User 8 s Buffer Structure 

MONDAY P 0 M O 


TUESDAY A* 


A e Linking Loader 
B® Libraries and UPDATE 
C e CHAIN and EXECUTE 


TUESDAY P e M® 

E 0 LAB 


v 




WEDNESDAY A.M, 


A ® 

Fortran and Macro Interface 

B @ 

DDT 

C e 


D e 

DUMP 

WEDNESDAY P 0 M C 

asa 

E e 

LAB 

F a 

Program and Homework Review 

G @ 

Quiz 2 

THURSDAY A S M S 


I/O Handler Format 


Sample Handler 

THURSDAY P a M a 

c. 

LAB 

D® 

Final Exam 

FRIDAY A.M. 

A© 

Monitor and System Modification 

1. PATCH 

2. SGEN 

B ® 

Uniehannel Discussion 

C a 

Final Exam Review 

FRIDAY P ffl M a 


Optional Lab 



BLOCK DIAGRAM OF THE PDP-15 system 


Computers a machine -which inputs data from the outside worlds 
processes the data, perhaps puts it in temporary 
storage and finally outputs the data and/or results in 
the form of hard copy,displays or commands to other 
devices it may be controlling® 


Program » a sequence of instructions to a computer^ 

specifying the necessary steps to solve a problem 
(sometimes it includes the data it is to work on). 






-main component 
-handles bidirectional 
communication with 
memory and I/O 
processor 

-performs arithmetic 
and logical operations 
-controls and executes 
programs stored in 
memory 


-main storage area 
within computer from 
which instructions 
are fetched and exe¬ 
cuted (data may also 
be stored here) 
-various types of 
memory available 


-handles peripheral 
data transfers 
-coordinates trans¬ 
fer betweeni 
CP & peripherals 
memory & 





UNI8US 



I/O l 



x 


PROCESSOR | 


I/O BUS 



CENTRAL 

PROCESSOR 


FLOATING 

POINT 

PROCESSOR 



•second general purpose 
processor 

■second I/O bus allowing 
use of PDP-11 peripherals 


^allows use of floating 
point arithmetic via 
over 100 instructions 
without use of complex 
software routines 


-allows operator 
communication in 
systemi 

-starting & halting 
of programs 
-monitoring of 
registers 
-modification of 
memory _ 





SOFTWARE 


To utilize the powerful PDP-15 hardware a number of operating 
systems have been developed (special applications packages are also 
available). See chapter 10 of the System Reference Manual for 
descriptions of each of these systems, 

DOS-15, DISK OPERATING SYSTEM 

Disk Operating System (DOS-15) is an integrated set 
of software designed to meet the demands of research, 
engineering, and industrial environments. It includes 
the software necessary for simplified programming 
and efficient operations. DOS-15 brings to the user the 
advantage of disk resident storage via rapid access 
to the system’s resources. 

The DOS Monitor, the heart of the system, incorporates 
all the functions of the “Advanced Software System” 
plus the added power of fully automatic random 
access file operation. The user controls the operating 
system by instructions to the Monitor. The Monitor 
runs the jobs, supervises data and file manipulation, 
and interacts with the operator/user in a simple 
conversational manner. ___ 


Noteworthy features of DOS-15 are: 

Disk Resident System Software 

All DOS-15 System Software resides on either DECdisk, 
or RP15 Disk Pack, or RK15 disk cartridge. 

interactive Operation 

An interactive keyboard/program Monitor permits 
device-independent programming, and automatic call¬ 
ing and loading of system and user programs. 


Conversational Mode. 

System Utility Programs interact with the operator/user 
in a simple, conversational manner. 

Pronframmsd Monitor Commands 
Input/Output programming is simplified by the use 
of a set of system commands which are standardized 
for system-supported I/O devices. 

I/O Device Handlers 

Data and file manipulating I/O device handlers are 
supplied for standard system peripherals, allowing 
device independence and overlapped computation, 
and I/O,. 

User-Created System Files 

The user may easily incorporate his own software 
into the operating system, thereby tailoring the system 
to his hardware and software needs. 

Programming Languages 

FORTRAN IV, FOCAL, and MACRO-15 programming 
languages are offered. 

Bank and Page Modes 

Choice of 8K (Bank Mode) or 4K (Page Mode) direct 
addressability. Page Mode operation permits mo difica- 
tion via the index register. 


Disk File Structure 

The disk file structure allows the most efficient use of 
disk capacity and data retrieval for processing via: 

System supported DECdisk, Disk Packs, and Disk 
Cartridge Devices, providing both economy and stor¬ 
age capacity.^,--"'' 

Virtually unlimited data capacity (Disk Pack = 83.7 
million words, DECdisk = 2.09 million words, Disk 
Cartridge = 9.6 million words). Random/Sequential 
File Access furnishes file protection through unique 
user directories and associated user identification 
codes. Files can be made invisible to other users, but 
with privileged access via a supervisory code. 

User/user file independence—identically named unfor¬ 
matted Input/Output (FORTRAN IV). 

Random Access-formatted as well as unformatted 
in put/ Qutput (FORTRAN IV)._ . ~~ 

Dynamic St@rsg© Altoeation 

The available disk storage is automatically allocated 
for optimum storage utilization. 

Dynamic Buffer Allocation 

input/Output core is automatically optimized by the 
Monitor. It allocates only that space which is required 
for the system and the user. 

latching Opsrattafi 

An alternative to interactive operation is a batching 
mode which permits the sequencing of console com¬ 
mands to come from paper tape or cards. 

input/Output Spooling 

DOS-15 systems using the RK15/RK05 Unichannel Disk 
System, provides spooling of card reader, line printer, 
and XY plotter data. 

Spooling is a method of storing (queueing) data to 
and from slow speed devices on the high speed RK05 
disk. This dramatically improves system performance. 

Spooling is only provided for devices interfaced to 
the UNIBUS of the RK15 Disk System (i.e., the CR11, 
LP11, LS11, and XY11). Spooling requires 8K of local 
PDP-11 memory,— 








The following software is available as part of DOS-15: 

Monitors 
Resident Monitor 
Keyboard Command Decoder 
Batch Processor 
System Loader 

PIREX (Peripheral Processor RK15 Only) 

Languages 

FORTRAN IV (F4X, FPPF4X) 

FOCAL 

MACRO-11 (Assembler RK15 Only) 

MACRO-15 (Assembler) 

ALGOL (optional) 

Text Editors 

EDIT 

EDITVP (Storage Scope Editor) 

ED1TVT (Graphic Display Editor) 


Linking Loader 

CHAIN & EXECUTE (Overlay Loaders) 
ABS 11 (RK15 Only) 

Debuggers 

DDT (Dynamic Debugging Technique) 
DUMP (Core Dump Lister) 

QF1LE (Store/Retrieve Core Dumps) 

OtSIiti©s (General) 

DTCOPY (DECtape Copier) 

MTDUMP (Magtape Utility) 

PIP (Peripheral Interchange Program) 
SRCCOM (Source Compare) 

UPDATE (Library File Manager) 
8TRAN (PDP-8 to PDP-15 Translator) 
89TRAN (PDP--8 to PDP-9 Translator) 
TKB (RSX-15 Task Builder) 

Utilities (System) 

DOSSAV (Disk Save/Restore) 
RFBOOT (DECdisk Bootstrap) 
RPBOOT (Disk Pack Bootstrap) 
RKBOOT (Disk Cartridge Bootstrap) 


I/O Handlers 

CDB (Card Reader for CR03B, CR15orCR11) 
DOSBCD (Batch Card Reader) 

DKA, DKB, DKC, DKL, (RF15/RS09 DECdisk) 

DPA, DPB, DPC, DPL (RP15/RP02 Disk Pack) 

RKA, RKB, RKC, RKL (RK15/RK05 Disk Cartridge) 
DTA, DTC, DTD, DTE, DTF, (DECtape) 

LKA (LK35 Graphics Keyboard) 

LPA (Line Printer for LP15, LS11 or LP1) 

LVA (Line Printer/Plotter) 

MTA, MTC, MTF (Magtape) 

PPA, PPB, PPC (Paper Tape Punch) 

PRA, PRB (Paper Tape Reader) 

TTA (Teletype) 

VPA (Storage Scope) 

VTA (VT15 Graphic Display) 

VWA (VW01 Writing Tablet) 

XYA (XY11 Plotter, RK DOS only) 

Checkout-Package 

RF.CHK (DECdisk Checkout) 

RP.CHK (Disk Pack Checkout) 

RK.CHK (Disk Cartridge Checkout) 

Minimum Hardware 

KP15 Central Processor 
16,384 18-bit Core Memory 
Console Terminal 

PCI5 High Speed Paper Tape Reader and Punch 

KE15 Extended Arithmetic Element 

TCI 5 DECtape Control 1 —or TC59 Magtape Control 

1 TU56 Dual DECtape Transport—or 1 TU10, TU20, 

or TU30 (7 or 9 track) Magtape Transport 

RK15 DECdisk Control or RP15 Disk Pack Control or 

RK15 System 

1 RS09 Disk Drive or 1 RP02 Disk Pack Drive or 
1 RK05 Drive _ 








Memory i the main storage area for computer instructions 
and system data® 

In order for a program t© be executed, it must 
be placed ( se loaded") into memory® 


Memory is storage space—>a place to keep things for a 
while® It can hold either data or instructions® 

Memory 9 often referred to as main storage 9 is much 
like a large chest of drawers® 



a 9 You can store something in each drawer® 

b B You must examine a basic storage unit when 
looking for something — in the chest this 
unit is a drawer % in a computer this unit 
is a location (word)® 

c® You refer to these basic units by numbers - 
you tell someone t© look for something in the 
3rd drawer from the bottomj you tell the 
processor to look for something in location 3 e 


In a computer, the numbers of the locations are called 
addresses® Address numbers begin with zero as shown above® 



Each location or word in a . TOP®15 is partitioned into 
smaller subdivisions called bits® Bits are subdivisions which 
have biliary values, either 1 or 0® 

Locations subdivided into bits are like drawers partitioned 
into small slots. To examine a bit p jon must first look at the 
entire locationg to look into a slot you must first pull out the 
entire drawer® 


0 1 234 567 8 9 JD U 12 B 14 B 16 17 



The bits in a location are also numbered beginning with 
zero^ but these numbers are not generally referred to as 
addresses® So you may imagine memory as a chest ©f numbered 
drawers # each containing numbered slots § or you may simplify 
your model and imagine a matrix of m numbered locations 9 each 
containing 18 numbered bits as shown below® 


















WORD LENGTH 


The FBP-15 has an 18 bit word 


The bits are labelled from left to right , 
starting with 0 and ending with 17a 


0 12 2 

.. \ 

most significant bit 
8S msfo 88 


4 5 6 7 8 9 10 11 12 13 14 15 16 17 

/ 

least significant bit 
88 Xsb” 


Because one octal digit is the equivalent of 
three binary digits, the contents of an 18 bit 
word is often given as a string of 6 octal digits a 


JBL JL X 111 XXX X X X XXX XXX 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 


0 7 1 6 2 5 

Binary value« 000111001110010101 

Octal- value? 071625 


SIGNED NUMBERS Words may be looked at as instructions or 

as data (numerical values). 

When viewed as numerical values 9 numbers 
are usually looked at as being SIGNED. 

The sign of a number is determined by 
the most significant biti 


MSB-Q 0 the number is POSITIVE 



EXAMPLES 


Positive numbers ~ 


010 

111 

001 

Oil 

101 

000 

OR 

271350 

000 

001 

101 

110 

010 

100 

OR 

015624 

000 

000 

000 

000 

000 

001 

OR 

000001 

000 

000 

000 

000 

000 

000 

OR 

000000 


Note that m 0 n (zero) is considered a positive number 
because bit Q e its most significant bit, is 0 e 


Negative numbers — 


101 

111 

001 

100 

010 

001 

OR 

571421 

111 

000 

000 

010 

110 

Oil 

OR 

700263 

111 

111 

111 

111 

111 

111 

OR 

777777 

100 

000 

000 

000 

000 

000 

OR 

400000 


Range — 


POSITIVE 

000000 

000001 

000002 

© 

0 



300000 


© 

© 



NEGATIVE 

777777 

777776 

© 

© 

© 

700000 

© 

© 

© 

600000 

© 

© 

© 

500000 

© 

© 

400002 

400001 

400000 




COMPLEMENT NUMBERS 


All negative numbers on the PDF-15 are expressed in 
COMPLEMENT FORM rather than sign-magnitude form, 

sign magnitude 

+5 000 000 000 000 000 101 OR 000005 

-5 100 000 000 000 000 101 OR 400005 


There are two forms of complement numbers used on the 
PDP-15i 

:wAa1 ^; © |g COMPLEMENT — the l*s complement of a binary number is 

the result of inverting each bit position® 



ex, 


number 010 101 
l*s coraplament 101 010 


001 000 100 011 OR 

110 111 011 100 • OR 


251043 

526734 



Note that when you add a number to its 1*s 
111 111 111 111 111 111 OR 

Hence, an easy way to compute the 1• s 
number is to subtract it from 777777® 


complement, the sum isi 
777777® 

complement of an octal 

777777 
- 251043 
526734 


2®s COMPLEMENT — the 2 @ s complement of a binary number is 

the result of adding to the l f s complement® 

i 9 e e (the 2 f s complement) » (the l's complement) + 1® 

ex a 

number ' 010 101 001 000 100 011 OR 251043 

1 *s complement 101 010 110 111 011 100 OR 526734 

2®s complement 101 010 110 111 011 101 OR 526735 

Note that an easy way t© compute the 2®s complement of an octal 
number is to subtract it from 777778 or a similar value 
value where the 8 is in the rightmost non-zero position of 
the number being complemented, 

251043 777778 BUT 251040 777780 

-251043 - 2fffQ40 

526735 526740 


Note that when you add a number to its 2®s complement t the sum isi 

000000 , 

251043 251040 

*526735 *526740 

000000 000000 




SOME CONSEQUENCES - 


1) There is no difference between the 1 9 2 and 2 9 s complement 
representation of positive numbers• 

2) There is a difference between the 1*s and 2®s complement 
representation of negative numbers® 


Positive Number 

1•s Complement 



2 f s Corapl 

000000 

777777 




000001 

777776 

( 

-i) 

777777 

000002 

© 

777775 

© 

( 

-2) 

777776 

© 

© 

017777 

700000 



700001 

100000 

677777 



700000 

100001 

© 

677776 

© 



677777 

® 

© 

377776 

© 

400001 



© 

400002 

377777- 

400000 (- 

-131 

,071) 

400001 

——— m 




400000 



-1 


Note that the 2®s complement of 400000 is 400000® 

400000 (-2 17 ) is too negative a number to have 
its complement (2 17 ) represented in 18 bits® 

The largest positive number which may be represented 
in 18 bits is 2^ 7 -4 or 31777!g or 131»071 .£q« 


Zero 


1) There are two forms of zero in 1 9 s.complement 


000000 
^ ^ 


) There is only on© form of zero in 2®s complementi 

000000 £ o « % 

is a, —1 ) © 






MOTEg There are 10000 (octal) locations in each page® 

Each page starts with an address that is a multiple 
©£ 10000 * 

There are 2000© (octal) locations in each banlc e 
Each bat* starts with an address that is an even, 
multiple of 20000 s 




















DOUBLE PRECISION ADDITION 


/ Program to illustrate the use of two f s complement addition in performing 
/ a double precision add. Two words are used for each DP number.. The 


w 

first word of the 

pair contains the sign and 

the most significant part 


The 

second word contains the low order part. 

It is important to note 

/ 

that 

all bits of 

the low order part are numeric bits, i.e.. 

the sign 

/ 

bit 

is considered 

as a numeric bit, not as a 

sign. For illustration 

/ 

purposes, assume 

that the word size is only 

six bits. Some 

DP numbers 

/ 

follow: 




/ 


NUMBER 

HIGH 

LOW 


/ 


0025 

000 000 

010 101 


/ 


0063 

000 000 

110 011 


* / 


0377 

000 011 

111 111 


/ 


-1 

111 111 

111 111 




-100 

111 111 

000 000 


/ 


-40 

111 111 

100 000 



The 

program to perform DP addition follows: 





CLAICLL 

/Clear AC and link 





TAD AL 

/Get low half of A 





TAD BL 

/Add low half* of B 





DAC CL 

/Save low half of result 





CLA 

/Clear AC- but link remains 




GLK 

/If addition of AL and BH 

caused a carry, 

link=l 




/and the one is placed in 

AC (17) so that 

it can 




/be added to the high half 

. If no carry. 

AC 17=0 



TAD AH 

/Add in high order parts of the two numbers 



TAD BH 






DAC CH 





/ 

EXAMPLE 1. DP ADD 127+ 

306 = 735 






HIGH 

LOW 


/ 

127 = 

000 

001 

010 

111 


/ 

306 = 

000 

011 

000 

110 



Add low order 



Oil 

101 

Link = 0 

/ 

Add high order 

000 

100 




/ 

Add in LINK 


0 




J 

Result 

000 

100 

100 

101 

= 435 


/ 

EXAMPLE 2. DP ADD 1254 + 

2362 = 

= 3636 






HIGH 

LOW 


/ 

1254 = 

001 

010 

101 

100 


/ 

2362 = 

010 

Oil 

110 

010 


/ 

Add low order 



Oil 

110 

Link = 1 

/ 

Add high order 

011 

101 




_ / 

Add in LINK 


1 





RESULT 

011 

110 

Oil 

110 

= 363 
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CSMTRAL PROCESSOR I■ the Central Processor Unit (CPU) functions 

as the main component of the eospmfeer by 
carrying ©n bidirectional conmnmieation with 
both the a@®ory and 1/0 Processor, Provided 
with the capability t© perforin all required 
arithmetic and logical operations! the central 
processor controls and executes stored programs. 
It accomplishes this with an extensive complement 
of registers 9 control lines, and logic» 


6 bits long 

Holds Bits 0-3 OP Code 

4 Indirect bit 

5 Index bit 


m 

Contains all 
irfornation going? 
from CPU* "to m@»@ry 
data lines 

Contains address, 
in Memory of next 
instruction to be 
executed 



FRO&S CONSULS 



Q& 

Temporary lefts' 

storage ©£ the 
operand address 
for all MRIs 


[ INPUT 

SATING ] 

( AfSITHygl 

ric UNIT H 


&1 words read from 
steaory into CPU enter 
(data and 
L 

COMSQLE 
“Bata Switches 
^Address Switches 
lights 
«©perate Keys 


Retains result® bi 
arithmetie/logieai 
operations 

Program controlled 
I/O transfers go j 
through the hC ° 



Index Register used 

isk Indexed, addressing 
©aerations, as a 
counter or for storage 


Used to set a limit 
am operations with the 
Index Register or for 
storage 


I&etesids capability 
of processor to do 
hardware multiply, 
divide,normalize 
and shift 


1 bit extension 
of the AC 


CPU options 

-Memory Protect 
-Memory Protect 
-p©«er£ail 










retrieve 

enter 

modify 


contents of 
memory locations 



OPERATE 74 10T 



-operate on 
link and ACi 
-clear 
-complement 
-rotate 


■input/ 

output 

transfers 



64 

-multiply 

-divide 

-shift 

-normalize 


INDEX 72 

-operation's- 
involving 
the XR 
tm lr 



OPERATION CODE 
OO0-6O g 


INDEX BIT * 
U«INDEXED) 


0 

1 

2 

H 

n 

H 

a 

D 

D 

B 

B 

11 

B 

B 

B 

15 

B 

B 


INDIRECT 
ADDRESS 
(1 INDIRECT) 


-Y- 

OPERAND ADDRESS 


* USED AS A THIRTEENTH ADDRESS BIT IN BANK MODE 


Memory Reference Instruction Word 


OPERATION CODE 


64g=EAE 
70 e =IOT 


72 8 = INDEX 
74g = OPERATE 
A _ 


1 

2 

3 

4 * 

6* 

6 

7 

8 

9 

10 

ft 

12 

B 

B 

B 

B 

B 


O 


INSTRUCTION CODE 


*THESE BITS USED AS PART OF THE INSTRUCTION CODE IN EAE AND 
OPERATE INSTRUCTIONS 


Augmented Instrucfion Format 











PASE I MCROSK $RC MACRO A8S1M8LY LANiUAIS StUMPLE 

S T1TU MACRO AS88MBIY LAN6UA61 EXAMPLE 


/ 

/ 

/ 


mim 

800100 

START JMP , 

00101 

$mim 

JMP START 

8iB 18 2 

@@010@ 

START 

j 

@il@3 

|4lli3 

DIM DIM DIM 

00104 

mum 

LAC DM 

0<8ifcS 

140000 

DIM 

mi®e 

000103 

OHM 

% 0 i 0 f 

000103 

©PSA DIM 

/ 

/VARIABLES 

man 

iii02s 

LAC CNT# 

mm 

04102s 

DAC CWT# 

00118 

201026 

LAC CNff# 

80111 

041026 

OAC CNTg 

/ 

/LITERALS 

00114 

801031 

A LAC Cl 

00110 

801084 

LAC TAILS 

00110 


LAC CTA0LE 

00117 

181033 

LAC CA 

00120 

801034 

LAC CC 

00181 

001034 

CS 


mmm 

0S000 

00108 

20103S 

LAC (8 

/ 

/INDIRECT 

00181 

800100 

LAC 100 

m 184 

82010® 

LAC# IIP 

00185 

isiisa 

LAC# STARTs® 

00186 

681000 

jmp# ai 

00I8F 

000100 

JMP 100 

mss 

600108 

JMp START 

01131 

621036 

JMP# Ciii 

/ 


EJECT 



MACRO ASSEMBLY UN6UA6I EMAMPLI 


PAGE 2 MCROEX SRC 


DM 

U 


/ 

/ 


«l«iS 




@t@@S 

@08114 


A1 


000100 


0*100 


000084 


C®4 

01006 

mmm 


0 

8i@@? 

000004 



01010 

umim 



@1011 

200114 



01012 

2il22i 



01013 

2@I03? 



01814 

2@l@4i 


A 

01015 

@01006 


f 

0 

@1016 

00103® 




000110 


i«f la 

01017 

100110 



01020 

2MH® 



@1021 

201041 


i 

diigg 

000010 



@!@23 

0i|i42 


A 

@1024 

iiliiP 


TABLE 


000111 



01031 

000001 

*L 


@1038 

@01084 

*L 


@1033 

000114 

*L 


@1034 

iiiii4 

*L 


il@35 

iiigi® 

*L 


@1036 

@01111 



01037 

@@@82® 

*1 


01040 

001087 



01041 

000110 

*L 


@1042 

777674 




SI2I®@f@44 


@ loc 100 s 

A 


B 

t* 

w 

LAC S 
LAC A, 
l,AC S*e*A 
LAC CB+C+A 
L*C cs# 

0 /MULTI-DEFINED 8VMB0L 

DO /UNDEFINED SYMBOL 

6 

LAC B 
LAC CB 

A-S+C 
A* CB+C) 


.END START 


4 ERROR LINES 



i 


00100 

@0i0i 


00101 

00102 

80103 

00104 

!@i@g 

m lac 
00107 
00110 
00111 


00112 

mn? 

mi 2§ 

00100 

0018® 


0ilg7 


P8EU00 SRC PSIUOO OPS DUMPIES 

gTlTUI PSIUOO OPS DUMPIES 

/ 

* ASS 

/ 

6 ioe im 

i 

280100 LAC 10® 


J4§0|i 

748010 

742810 

?4gii0 

140111 

140113 

148114 

140118 

140110 


000000 

000000 

mmm 


i@®lig 

141113 


/ 

/***##****#***#**♦*****•********* 
/ # RIPT 

i 

aRSPT A 
R T L 


@ RgPT ill 
ZERO DIM BUFF 


/ 

/***#*«*********♦**•***********•* 
/PtgSERVfNS STORAGE 

/ 

8 UFP . 8 i®m s 

iUFFf i 
/ 

TABLE I 

a ioe *>s 
TABLES 0 
/ 

/*##0**#*#*O** **#***#*♦*• ******* 

/CONDITIONAL® 

/#*****#****•#**«*#**•***#****#•* 

/ 

©IFDEF A 
LAC Ail 
aiNOe 

Big 



9 8N0C 

/ 

/****##*********♦*****♦***♦****♦* 
/PAWN© THE L18TIN9 
/***#*******#***♦###*#***♦***♦*•* 



PASE S PSEUDO SRC PSEUDO OPS EXAMPLES 

/ 

/***#*9**O#**#0O99009***t*##**9 

/CHANQING THE LOCATION COUNTER 

L ###«? 

/ 

ilili ®L0C 1®B® 

/ 

/•ASCII AND @81XIT 

/«***#*###•*#***#*##9*###******** 


81151 

488i|@ 

MESS 

.ASCII 

/A 8R0KEN/4li^4|2i» 


illSi 

891036 





01992 

458131 





@1093 

m$4m 



/ UP MISSAfill/ 


®I@S4 

2928 M 


.ASCII 


01955 

990292 





iltse 

4ii47f 





91057 

340616 





01800 

4@S@ii 





01081 

®0i000 

1 



-w 

@1082 

4iiil@ 

HISS 1 

.ASCII 

? ABClIS 1 


@1983 

330844 





01004 

314088 





01089 

mmm 

J 


... - 


01069 

910209 

NAME! 

.SIXBT 

'ABC18S ' 


@i@@7 

6i§f§3 

/ 

HiSSi 




@1078 

4i@il@ 

.ASCII 

• ABC1 * 


@1071 

33@4ii 





01872 

@10293 

/ 

NAMES 

.SIXBT 

1 ABCl 1 


@1073 

@i©ii@ 

/ 

HSSSS 




01074 

4iSiSi 

.ASCII 

<AB'>Ci23/ 


@1079 

992544 





@107® 

3I4®§® 





il@77 

s@@@i@ 

j 




0ll@i 

@10213 

NAMES 

, SIXBT 

'ABI/C1E3/ 


01101 

016285 




"■w 


/ 

A*************************7***** 

/PASS EJECT ALSO CAUSED BY .TITLE 
/**«** ****«# * * 

/ 




»ABE 3 PSEUDO SRC 


PSEUDO OP EXAMPLE8»»TH|8 PA8ES MACROS 

a TITLI PSEUDO OP eXANPlBS*»THX8 $m% MACHOS 


/ 

/ 

/OIFlNINfi k MACRO 
/#****« 
i 

aOIPIN 8Ui AbSiC 
LAC I 
ISA 
TAB A 
DAG C 
glNOM 
7 

/*****************«********••♦*** 
/CALLING A MACRO 

/#♦##*#***##*****•*•************• 


..-'■‘“'X 


/ 





SUE BUPPE,8UPF.TABLE 

euea 

mmn 


LAS lUPP 

81113 

?mm i 

m 

TCA 

81104 

imw 


TAB BUFFI 

01115 

@40120 

<&s 

j 

DAC TABLE 



/ 

SUB BUPPE,CS,TABLE+1 

81106 

201124 

© © 

LAO es 

8110? 

740031 

*n 

TCA 

Tl 01110 

341117 

*© 

TAD BUPPE 

01111 

®4® |2i 

$© 

OAC TABLE*! 



/ 

SUB CMBSSls(MEBBiTABU 

81112 

201125 

*6 

LAS CM88S 

01113 

740001 


TCA 

@1114 

341126 


fAO CMI881 

01115 

®4ilgg 

#© 

DAC TABLE*8 

y~\ 


/ 

SUB BUPPE.TABLE,TEMP# 

©111® 

g@ilg0 

*Q 

LAE TABLE 

@111? 

741031 

#8 

TCA 

01120 

34011? 


TAD BUPPE 

81121 

041 isa 

^8 

j 

OAC TEMP# 


i®ii@@ 

r 

.END 

iiiti 

mmm 

*L 


01124 

mmm 



anas 

m%%m 

*L 


81126 

iiii@g 

*L 



si 2 s««iii? 

MO ERROR LINES 







THERE ARE 4 PROGRAMS IN THIS SERIES. THEY OFFER 
SOLUTIONS {EACH USING A DIFFERENT ADDRESSING MODS) 10 THE 
8AM| PROBLEM! 

TABLES A s B AND S EACH CONTAIN 0-ONE WORD 
ENTRIES. ABB CORRESPOND!N0 ENTRIES FROM 
TABLES A AND 8 AND STORE THE RESULT IN THE 
CORRESPONDING ENTRY IN TABLE C, 

i.e. cm * Am + 8 m. 

DO THIS WITHOUT CHANGING ANY OF THE VALUES 
IN TABLES A AND I. 


THESE PROGRAMS WERE WRITTEN TO ILLUSTRATE THE VARIOUS 
TYPES OF ADDRESSING AVAILABLE ON THE PDP-1S AND TO DEMONSTRATE 
CERTAIN MACRO LANGUAGE ELEMENTS AND ASSEMBLER DIRECTIVES! 

(8-112-195 *STATEMENT FORMAT 


(3-5) 


(8-105 


C2I®> St 15 


C2-S3 


CM) 

CS^ISI 

3 

ca^ts) 

(3*U) 


♦ TYPE OF BINARY OUTPUT TO 81 ©EHEKATES 

• AiS 
, ASSP 

♦SITTING THE LOCATION COUNTER 

«Loe 

♦FITTING HSAD&N08 ON AlSfMILY LISTINGS 

TfTI W 
$ * * f 

♦SPEC!PTINS WHETHER NUMifRS kM OCTAL OR 
DECIMAL 

@ DEC 
«OCT 

♦ RESERVING-BLOCKS OF MgMORT FOR STOP All§> 

a BLOCK 

^VARIABLES 

USING # 

♦LITERALS 

USING O 

♦DEFINING THi VALUg OF 8TMI0LS 

USING THi STNiOL AS A LABEL 
USING DIRECT ASSIGNMENTS 

■•STORING VALUES IN SUCCESSIVE LOCATIONS 

•SPECIFYING THE PHYSICAL ENO OF PROGRAM 
.END 


THE ABOVE IS JUST A SELECTED LIST OF ASSEMBLY LANGUAGE ELEMENTS 
AND ASSEMBLER DIRECTIVES (ALSO CALLED PSEUDO OPERATIONS). 

MAKE SURE YOU ARE FAMILIAR WITH THEM, EACH TOPIC IS DISCUSSED 
IN THE MACRO MANUAL STARTING ON THE PAGE GIVEN IN PARENTHESES. 



PAGE i 


SUM 


COMMENTARY ON SUM 


SRC 


/ 

/ 

/ 

/ 

/ 

/ 


.TITLE COMMENTARY ON SUM 

***** #♦**##*###*#■***#*** 

* 

* POINTS TO BE NOTED « 

* # 


/ 

/M. NOTE THE .TITLE STATEMENT AND WHAT IS PRINTED AS 
/A HEADER. 
t 

/*2. THE FIRST COLUMN SITES* LOCATIONS. NOTE THAT THE 
/■LOCATION COUNTER SESINS AT IPS. (BECAUSE OF ".LOC 108) 


/ 

THE 5? PAC COUNTS INSTRUCTION REPfPENSli LOCATION %{ 
/ 5t eOUNT# 5? IS USED IN AN X8Z INSTRUCTION IN LOCATION 110 
/THIS INSTRUCTS THE ASSEMBLER TO SET UP A LOCATION WHIP 
/MAY BE REFERRED TO AS ^COUNT* 5 , THE ASSEMBLER SET UP 
/LOCATION 133* (COUNT IS A VARIABLE) 

/ ' 

/*4® VALUES ARE SET UP IN SEQUENTIAL LOCATIONS FOR 
/TABLES A AND B # IN EACH CASE THSRI ME ACTUALLY 5 
/STATEMENTS ON ONE LINE (STATEMENTS ARE TERMINATED BY 
/SEMICOLONS AND CARRIAGE RETURNS} # NOTE THE SPACE 
/BEFORE EACH VALUE® 

/ 

/*$* NO NEED TQ ACTUALLY PLACE ANY VALUES IN 
/TABLE C^wJUST TO REStSVE- STORAGE fWkCE. THE ".BLOCK , v 
/HAS THE EFFECT OF ADDINS 5 TO THE LOCATION COUNTER. 
/NOTE THE ADDRESS OF LOCATION l? ENDLOS sl « 

/ 

THE f %END» STATEMENT INDICATES THE PHYSICAL END 
/OF THE PRODRAM AND MUST BE THE VERY LAST STATEMENT s 
/IN A PROGRAM. NOTE THAT IT IS SKLOM COMMENTS. 

/WHAT DO YOU THINK WOULD HAPPEN ON TMF LISTING IF THE 
/".END" STATEMENT APPEARED BEFORE THOSE COMMENTS? 

/ 

/*/. NOTE THE USE OF THE REJECT* 1 STATEMENT C80 THAT ' 
/THE LISTING WILL CONTINUE QN A PRISM PAGE) IS MOT 
/NECESSARY BECAUSE A ".TITLE" STATiMENT ALSO 
/GENERATES A FORM FEED WHICH CAUSES THE LIST1N6 
/TO CONTINUE ON A FRESH PAGE. 

/ -■ 




E® 



Rfc 2 SUM $RC SOLUTION USES AN ADDRESS MODIFICATION TECHNIQUE 

.TITLE SOLUTION USES AN ADDRESS MODIFICATION TE 

/ 

a ABS /ABSOLUTE PROGRAM' LOADED BY THF 

/A80LUTI LOADER I TO RUN IN BANK MODE 


<%(/<! 00 


& 

@ LOC 18® /SET 

LOCATION COUNTER TO 108 

0 0 1 0 0 

777773 

/ 

START 

LAW 


/SET UP NEGATIVE COUNTER OF «5 

0 0 | 0 | 

$40133 

j. 

OAC COUNT 


/AS EACH TAILS HAS 5 ENTRIES© 

00102 

200113 

/ 

A A 

LAC A 


/PERFORM ADDITION 

00103 

3401g0 

SB 

TAD 0 


/OF ENTRIES 

0 0 1 e*i 4 

040125 

/ 

p* f* 

W v 

DAG C 


/STORE RESULT IN C 9 

00 | 

44010? 

/ 

XSZ A A 


/MODIFY LOCATIONS AA # B0 AND CC 

00106 

440103 


ISZ 00 


/SO THAT THEY REFERENCE THE 

0 010 7 

440104 


ISZ CC 


/NEK? LOCATION IN THE TABLE, 

0 0 1 10 

440133 

/ 

J 

ISZ COUNT# 


/ARE WE DONE? 

00111 

600102 

/ 

JMP A A 


/NO 1 ®«»8BCAUSE WE DIDN’T SKIP 



J 



/SO BASK FOR MORE® ' 

00 1.1 2 

74004® 

/ 

HIT 


/YES I DONE® 

/1 NOTE I IF THIS PROGRAM IS TO 
/RUN AGAIN AA g @B AND CC SHOULD 
/BE REINITIALIZED (CAN YOU THI 
/OF WAYS THIS COULD BE DONE?! 



/SET UP 

A 

TABLES 



00113 

000801 

/ 

k 

i! 21 31 4f 

s 


0^114 

mmm 





001 15 

000003 





0 ® 11 6 
0811 7 

000004 

008M05 





0 0 120 

000002 

B 

21 2! 21 21 

2 


00 121 

000002 





001 22 

008002 





0 0 12 3 

000002 





00 12 4 

000802 







/JUST RESERVE SPACE 

M 

FO 

R TABLE C 

0 0 12 5 


9 

c 

/ 

ENDLOC 

@ BLOCK 0 



0 01, 3g 

880000 

0 




/ 

/THIS IS THE END OF THE PROGRAM«, 
/THEREFORE# THIS IS WHgRg Wg WANT TO PUT 
/THE STATEMgNTe 

/ 

0001®® @END START 

§IZ!®00!34 NO ERROR LINKS 



PAGE 1 


SUM! 8RC 


COMMENTARY ON SUM! 


.TITLE COMMENTARY ON SUM! 

*******e***«***»*«#®*®' 
« POINTS TO m NOTEO 


i 

/*!, THIS PROGRAM USES INDIRECT ADDRESSING THROUGH 
/LOCATIONS AA.80 AND CC. LOCATION AA CONTAINS THE 
/ADDRESS BP TABLE A'. NOTE THAT THIS X® ACCOMPLISHED 
/SIMPLY 8V PLACING THE SYMBOL "A* XN ?U£ OPERATOR 
/PIELD, WHEN THE ASSEMBLER EVALUATES THIS STATEMENT, 

/IT LOOKS THROUGH ITS SYMBOL TABLES PSR THE VALUE OP 
/SYMBOL "A% «e»MOTi THAT TH2 VALUE 9P THE SYMBOL "A" 

/IS il®( THE ADPRR08 or THE? LOCATION X? NAMES*.-.*. 

/NOT THE CONTENTS OP THE LOCATION IT NAMES, THIS IS 
/A VERY IMPORTANT DISTINCTION!! 

/ SIMILARLY, LOCATION BB CONTAINS THE A00RES8 OP 
/TABLE 8 BECAUSE THE SYMBOL "6“ I® GIVEN AS THE CONTENTS' 
/OP LOCATION BBo THE VALUE Of THE SYMBOL 0 13 THE 
/ADDRESS OP THE LOCATION IT NAMES, !8ij NOT THE CONTENT 
/DP THAT LOCATION, SIMILARLY POR LOCATION CC. THE — 

/CONTENT OP LOCATION EC IB GIVEN AS ®C»„ THE VALUE OP _ 
/THE SYMBOL *C® IS 130, THB ADDRESS OP THE LOCATION 
/IT NAMES, HENCE, THE CONTENT DP LOCATION EC IS ISP, 

/ 

/*g. NOTE THAT DATA IS SEPARATED PROM THE INSTRUCTIONS 
/WHICH OPERATE ON THB DATA, Wg DC NOT WANT TO«PALL INTO 
/THE DATA AND START EXECUTING IT, WHAT INSTRUCTION WOULD 
/Mg HAVE IP WE "PELL INTO" AND TRIED YD EXECUTE LOC US* 

/«3, NOTE THI USB OP "COUNT" AS A VARIABLE, {WHAT IS IT ~ 
/IN THI UM OP THE SYMBOL "COUNT" THAT HAKES IT A 
/A VARIABLE?). WHAT LOCATION IS «gT Up BY THE ASSEMBLER 
/SO THAT IT MAY BE REFERENCED USING "COUNT"? 

/*«„ NOTE THAT WE RESERVE SPACE FOR TABLE 6 EVEN THOUGH 
/IT I § AT THI VERY gNP Of THE WRITTEN PP?Q©?5AM„ WHAT 
/PROBLEM WOULD WE RUN INTO IP WE DID NOT RESERVE THIS 
/SPACE? (HINTS SEE NOTE *SJ 
/ 

/*S, THINK ABOUT THE "LAG* AA» INSTRUCTION IN LOC 1P2. 
/THIS SAYS? LOAD THE ACCUMULATOR WITH THi CONTENT OF 
/THE LOCATION POINTED TO SY LOCATION AA. THE FIRST TIM® 
/THRU, LOCATION AA CONTAINS 113.THE ADDRESS OF THE FIRS*- 
/LOCATION IN TABLE A, IN LOCATION 188, THERE IS AN 
/«I8Z AAN.I.E. INCREMENT THE CONTENT W LOCATION AA BY i 
/(SO THAT AA NOW POINTS TO THE NEXT ENTRY IN TABLE AS. 
/THUS, THI NEXT TIME «LAC«AA» IS PiSieUTPB, THE 66 IB 
/LOADED WITH THE NBSfT ENTRY PROM TABLE A, THIS METHOD 
/IS VERY NICE FOR STEPPING THROUGH TABLES. NOTE.HOWEVER, 
/THAT Mi HAVE Yf! UPDATE LOCATION AS OURSELVES WITH THE 
?"IW' INSTRUCTION, BY USING AUTO-INCREMENT RESISTERS 
/WE CAN GET AROUND THIS, 886 SOLUTION SUM?, 

/ 



PAQg t SUM1 SRC SOLUTION USES INOIRECT ADDRESSING 

.TITLE SOLUTION USES INDIRECT ABBR68SIN8 


.ASS 


m ipus 


/ 

a l9C 188 

00100 

777773 

START 

UN *5 

00101 

040135 

/ 

0AC COUNT® 

00|@g 

aaaias 

Hint 

LAC* kk 

@@103 

560196 


tad* m 


060187 

s 

DAC* ec 

00105 

440185 

r 

181 kk 

@@106 

448126 


m sb 

'^\ @ @ i @ 7 

"1 

440187 

i 

xsz CC 

00110 

440135 

f 

W COUNT 

00111 

S00I02 


JHP NEXT 

win 

740040 


HIT 

@@113 

@@08®1 

h 

If 81 51 4 

00114 

semes 



@0118 

000003 



3@116 

000004 



0011? 

@08008 



^ 00100 

B0SS0S 

% 

if 51 41 5 

00101 

000003 



0012a 

@00004 



®0i§3 

000005 



@@124 

000008 



@@125 

000113 

kk 

A 

00105 

000180 

SB 

B 

mH7 

000130 

CC 

C 


/ 

00138 C .8LO0K S 


/SET UP A COUNTER OP -B 


/tee AA CONTAINS THE ADD. 
/OR a; LAO* AA SETS THE 
/CONTENTS OF & IN AC. 
/ETC, FOR BB 
/ETC. FOR CC 

/INCREMENT the indirect 
/ADDRESSES OP AA8SB 
/AND CC. 

/SEE IP 1 ALL DONE. 

/NOT DONE. SET NEXT DATA. 
/ALL DONE 80 HALT. 


/RESERVE SPACE FOR TASLE C. 


9mm 

SI2E8M136 


.END START 
NO ERROR LINES 



35 



A9E 1 


SUMS SRC 


COMMENTARY ON SUMS 


COMMENTARY ON SUMS 

A**********************' 
® ' 

# POINTS TO m. NOTED - 

* ! 


/»|, NQTI THAT IN THIS PRMffWs DATA APPEARS BEFORE THE 
/INSTRUCTIONS IN THE PiOSRAM. TH8 IMPORTANT THINS 19 T! 
/SEPARATE THE DATA PROM THE INSTRUCTIONS? BUT IT 00E8NM 
/MATTER WHICH APPEARS FIRST, 

/*2 0 HOTS THAT THE FIRST SKCCUTABLg ROGATION IN A PRO® 
/SRAM IS NOT ALWAYS IN THE FIRST LOCATION USED BY THE 
/PROBRaMo THAT IS, THERE CAN 03 A DIFFERENCE BETWEEN TH1 
/PROGRAM START A0DR890 AMR THE Pf?D8P£M LOAD ADDRESS, 

/IN THI® CASE, THE PR08RAM START ADDRESS iQ It?. WHERE* 


/* 5 0 THI® FROORAM MAKES USE OF AUTO-INCREMENT A0aRC98INb“ 
/(WITH LOCATIONS IB, tic &m \P.\ „ TO ACCESS SEQUENTIAL 
/LOCATIONS IN TASLBS A e S AND C RESPECTIVELY CLACeJS, 

/' AS %HI»°mIaN 8 J THAT Hi WANT TO LfiAO LOCATION JR WITH A 
/VALUE I LESS THAN THE START ABDREiS BP TABLE A. 

/LOCATION U WITH A VALUE 1 LESS THAN TH *J3 A *J *°$*|; 88 
/TABLE 0 AND LOCATION IS WITH h VALUE I LESS i HAN .THE 
/START ADDRESS OP TA8LB C. NOTE THAT THE "LAC fA»l" 

/and "OAC 18" INSTRUCTIONS ARE USED (LOCATIONS 121 AN8 
/(gs>3 TO DO THIS. 

/ the use op "£A«.1» REQUESTS THE ASSEMBLER TO SET UP 
/A LOCATION CONTAINING THE VALUE »A«|», THE ASSEMBLER 
/CAN EVALUATE EXPRESSIONS AMO DOES 80 MOVINS PROM LEFT 
/TO PISH?.„„A~a O J 00-1 * TP■ LOCATION 13fi IS SET UP TO 
/CONTAIN THS ??. THE INSTRUCTION "LAC CAwl" 18 ASSEMBLED 
/AS 209158 (LOAD THE ACCUMULATOR WITH THE CONTENT OF 

/LOCATION 13B.I.E., THE 7?), ... N .. u 

f SIMILARLY "LAC (0=4" LOADS THE ACCUMULATOR WITH 

/ma4» and "lac tc«i* load® the accumulator with •m ll « 


/*4, TO STORE THE "FT" IN A080LOTB L02ATI3N 10 A 
/"QAC I®" INSTRUCTION 19 USED. WOULD MS ME LOADING THE 
/»pp« INTO AB80! UTC LOCATION 10 IF THE " 0 I0C* STATEMENT 
/READ ».LOC 29009" BATHER THAW » s tOC 188"? 

/ 



PAGE a SUM2 SRC SOLUTION USES AU?0*tNC9fHINT ADDRESSING 

a TITLE SOLUTION USES AUTI^INCREHINT AQD«IBSIN§ 

/ 

\ / 

$ 

.ASS 

00100 .LOC IS® 





00100 

000001 

A 

II 2S 

31 41 i 

00101 

Biiiig 




00108 





00103 





@0114 





mxm 

@00003 

i 

81 41 

II 8f 3 

00106 

900094 




m 107 

@@@@01 




00110 

@00005 




00H1 

000003 




90118 


C 

4 

.BLOCK B 

@0117 

777773 

ST AST 

LAW 

EiS 

00120 

i40|35 

j 

QAC 

COUNT# 

mil 

800136 


LAC 

CA^t 

@01 it 

@4§§ | 0 

A 

SAC 

10 

@@183 

800137 

f 

LAC 

etui 

00124 

040011 

A 

P AC 

ii 

00125 

gii!4@ 

f 

LAC 

CC*1 

00180 

@4ii|g 

i 

9AG 

12 

00187 

22@@t@ 

NMT 

LAG# 

10 

@0|3@ 

MfSiti 


TAD# 

11 

@@131 

@50012 


DAS* 

12 

@® 138 

448135 

J 

181 

COUNT 

§@133 

§l@127 

/ 

W 

NKT 

@0134 

?4S@4® 


HIT 



00138 

still? 

MM77 

®L 

@end start 

0013? 

@§@104 

#L 


00140 

fit fH 0 H !i i» 

#L 



SXZM08141 

no error lin 


/PUT »S INTO COUNT 


/THIS METHOD MAKES USE OP 
/AUTQ»INGREMENT REGISTERS 

/18.11 AND IS. SINCE 
/AUTObINCBEMBNT is a PRE¬ 
INCREMENT, EACH OP THE 
/RESISTERS MUST BE LOADED WITH 


/ONE less THAN THE 8TARTIN0 ADO 
/ 

/ 

/TO ASSURE THAT THE LOADING OP 

/AN AUTOwINCREMENT REGISTER WIL 
/WORK IN ANT PAGE OR BANK. THE 
/INSTRUCTION TO LOAD LOGS 1W, 11 
/AND 18 SHOULD BE 0F THE POSH 
/ LAS C*•! 





PAGE 1 


SUMS SRC 


COMMENTARY ON SUMS 


.TITLE COMMENTARY ON SU 

/ 



/ 

/*!, NOTE THg Uig OF » 0 A®IP 8l a THIS WOMAN HHf4g§ USg OF 

/INDEMgD AODRE®S|NS AMO#THEREFORE#IMUSTI BE IN PhUE NODE 
» 

/*i, NOTE THE USE OP THE "OBA" INSTRUCTION. ALTHOUGH 
/A "DBA" INSTRUCTION 18 CONTAINED IN THE PAGE MODE 
/VERSION OP THE ABSOLUTE LOADER CKHI6H IS OUTPUT ON THE 
/PAPES TAPE IN FRONT OP VSUP A3@EMSH.ED PROGRAMS. IT IS 
/STILL A 8080 IDEA TO INCLUDE 6 IN YOUR PROGRAM 

/IN BASE THE PROGRAM IS RESTARTED PROM THE CONSOLE 
/WITHOUT RELOADING IT. CONST RELY ON THE CONSOLE 
/BANK«=PA8E MODE SWITCH. 

/«3 0 NOTE THE USE OP THE ",086" AND “.OCT" ASSEMBLER 
/DIRECTIVES. COMPARE THE VALUES GENERATED FOR THF 
/NUMBERS STATED WHILE UNDER DECIMAL RADI* {BASE 10) . 
/WITH THOSE GENERATED FOR THI NUMBERS STATER WHILE 
/UNDER OCTAL RADIX (BASE 13. 

/ 

/*4. NOTE THE ".END BEGIN®! " STATEMENT. A ".END" 
/STATEMENT IS USED TO SPECIFY THE PHYSICAL END OR 
/A PROGRAM. A "START ADDRESS" OB "TRANSFER ADDRESS" 
/(THE LOCATION AT WHICH HE WANT THg LOADER TO START THE 
/PROGRAM! MAY ALSO 98 SPECIFIED IN THE .END STATEMENT. 
/THIS IS DONS BY FOLLOWING THE ".END" WITH A SPACE OR 
/TAB AND THEN GIVING AN EXPPE3SIDN WHICH MAY 81 EVALUA- 
/T6D BY THE ASSEMBLER. IN THE PREVIOUS EXAMPLES, 

/WHIN A TRANSFER ADDRESS WAS GIVEN IT WAS A VIST 
/simple expise@gSQN.eTHe label used on the first 
/EXECUTABLE LOCATION. BUT THE ASSEMBLER CAN HANDLE 
/LONGER EXPRESSIONS. IN THIS CAGE, THg SYMBOL BEGIN 
/THE VALUE ii@@S s THEREFORE, BESIN<»mB0Ge, — 

/THUS, IN THIS £A®g, ".END BE0IN.1" HAS THI SAME 
/IPPECT AS ".END 
/ 

/*S. NOTE THE ERROR DIAGNOSTIC GIVEN ON THE STATEMENT- 
/TO BE ASSEMBLED INTO LOCATION tS@0@. THE "N" INDICATES 
/AN ERROR IN NUMBER USAGE. WHAT 13 THE ERROR? 

/HOW WAS IT HANDLED BY THE AS3E«@!, SR (COMPARE LOCATIONS 
/10080 AND 100883? 

/ 




PASI 2 SUM3 SRC 


/ 

/ 


0i00 


ROUTINE USES INDEXED ADDftESSIMS Cl LIMIT W6I8UR1 
.Title ROUTINE USES INDtXED A00»E8SIN6 Cft UNIT 


.amp 

a10 C l®i@W 
01A 


/enter pass mode 


10101 

800058 

9EQIN 

LAC CS 


/PUT B IN LIMIT RIO'. 

imm 

722000 

£ 

PAl 


!@i®3 

758008 

ff 

i 

tit 


/XR*8 

10524 

210014 

/ 

AA 

IAS A© K 


/A0BM98 OP A * CCX05*. 

i@iii 

388821 


TAD 5,X 


/ETC, 

i®i@8 

090026 


oac ta 


/ETCs 

10207 

723001 

/ 

AMS 1 


/INCREMENT AND TEST X® 

10010 

608084 


JMP AA 


/XR « LR 

10011 

74884® 


HIT 


/XRsLR. WE'RE DONE! 






/CHECK RESULTS VIA CONSOLE. 

10012 

000000 


CAL 


/RETURN TO MONITOR 

10013 

000019 

4 

15 


/ST HITTING CONSOLE CONTINUE 



f 

a DEC 



10014 

000002 

A 

21 59 ISP 

27 9 

98 

10010 

000008 





10010 

000014 





10017 

000033 





lift® 

030072 








ftf»T 

© lags 9 



10021 

000002 

8 

21 91 121 

171 

86 

10022 

00030S 





10823 

000812 





10024 

000827 





10085 

000872 





10026 


G 

A 

.BLOCK g 




010900 

/ 

@END SESIN^I 


IMM 

000005 

*L 





0172410034 

i mum 

LXNCi 

1 
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/PROGRAM TO ADD TWO NUMBERS, USING TAD, AND TEST 
/THE RESULT FOR ARITHMETIC OVER FLOW. 

/CLEAR THE LINK AND THE AC. 

/GET THE FIRST § IN' THE AC. 

/GET RID OF ALL BITS EXCEPT THE SIGN. 

/ADD THE 2ND NO. TO BIT 0 OF A. 

/SKIP IF ZERO LINK 

/NON ZERO LINK INDICATES BOTH A. AND B NEG. 
/BECAUSE ONES IN BOTH SIGN POSITIONS IS 
/THE ONLY WAY THE LINK CAN BE SET SINCE ONLY 
/THE SIGN BIT OF THE 2ND # IS ADDED 
/GET RESULT SIGN INTO LINK. 

/SKIP IF ZERO LINK 
/LINK=1, MUST BE +-. 

/LINK= 0 g MUST BE ++. 

/SINCE ONE VALUE IS + ADD 

/THE OTHER IS CORRECT ADDITION IS ASSURED 
/NO TEST IS NECESSARY 3 SO STORE THE SUM 
/AND HALT. 

/IF THE SUM OF TWO POSITIVE NUMBERS GIVES 
/A NEGATIVE RESULT 3 ARITHMETIC OVERFLOW HAS 
/OCCURED 5 TEST THE AC FOR POSITIVE VALUE. 

/IF NEGATIVE , GO TO ERROR ROUTINE. 

/POSITIVE RESULT SO SUM OK, STORE RESULT 
/AND HALT. 

/IF THE SUM OF TWO NEGATIVE NUMBERS GIVES 
/A POSITIVE RESULT, ARITHMETIC OVERFLOW HAS 
/OCCURED 3 TEST THE AC FOR NEGATIVE VALUE. 

/IF POSITIVE, GO TO ERROR ROUTINE. 

/NEGATIVE RESULT SO SUM OK, STORE RESULT 
/AND HALT. 


START 

CLA! 

CLL 


TAD 

A 


AND 

MASK 


TAD 

SZL 

B 


JMP 

RAL 

SZL 

NEGNEG 


JMP 

POSNEG 


JMP 

POSPOS 

POSNEG 

LAC 

A 


TAD 

B 


DAC 

HLT 

SUM 

POSPOS 

LAC 

A 


TAD 

SPA 

B 


JMP 

POSERR 


DAC 

HLT 

SUM 

NEGNEG 

LAC 

A 


TAD 

SMA 

BQ 


JMP 

NEGERR 


DAC 

HLT 

SUM 

MASK 

400000 


/ANOTHER, SHORTER SOLUTION FOLLOWS: 

/IF THE OR’ED 


LIKE 


LAC 

A 

XOR 

B 

SMA 


JMP 

LIKE 

LAC 

A 

TAD 

B 

DAC 

SUM 

HLT 


LAC 

A 

TAD 

B 

DAC 

SUM 

AND 

(400000 

XOR 

B 

SPA 


JMP 

ERROR 

HLT 


SOLUTION MAKING 

CLL 


LAC 

A 

ADD 

B 

SZL 


JMP 

ERROR 

DAC 

SUM 

HLT 



SUM OF THE SIGN 
/BITS IS A 1, THE SIGNS WERE 
/DIFFERENT AND THE SUM MUST BE CORRECT 
/SIGNS WERE THE SAME 


/PERFORM THE ADDITION, AND THEN 
/CHECK THE SUM FOR A CORRECT SIGN 
/ 

/GET SIGN OF RESULT 
/GIVES A SIGN OF 0, 

/RESULT IS THE SAME 


IF OR ? ED SUM 
THE SIGN OF THE 
AS THE SIGN OF B 


/SINCE A & B WERE SAME SIGN, RESULT IS OK 
/SIGN CHANGED, OVERFLOW OCCURED 


/CLEAR LINK 

/ADD THE TWO NUMBERS 

/IF EITHER NO. IS NEG., IT MUST BE l's COMP 
/IF LINK IS SET, OVERFLOW 
/OCCURRED, GO TO ERROR 
/ADDITION OK IF LINK=0 








ADDRESSING 


References: Volume 1 Processor Handbook 4>*3 

System Reference Manual 8-1 


Memory Reference Instructions specify locations to be operated 
on by the Central Processing Unit. The CPU computes the actual 
(effective) address of the location referred to by combining bits 
from the instruction itself and also from the PC at the time the 
instruction is being executed. Various addressing modes require 
further computations with pointer words and the index register. 

In the following illustrations: 


PC: refers to the contents of the Program Counter at 

the time the MRI is being executed. 

Instruction: refers to the contents of the location being 

executed. 


XR: refers to the contents of the Index Register. 

refers to the contents of the location designated 
as a pointer word in an indirect reference. 


Pointer Word: 



DIRECT ADDRESSING 



Effective Address 

MOTE that the effective address .is in the' saiae page as 
the instruction® 


bank mm 

PC 

ob¬ 
last ruction 



O 1 2 34 5 6 7 0 9 10 11-12 33 14 35 1© 17 



.. ... _ .. Effective Address 

NOTE that the effective address is in the same bank as 
the instruction® 



INDIRECT ADDRESSING 



Effective. Address 


NOTE that the pointer word is in the same page ms the instruction 
NOT® that the effective address is in the same block (32R) as 

the instructions 





Address 


NOTE that the pointer word is in the same bank as the instruction 

NOTE that the effective address is in the same block (32K) as 
the instruction. 







INDEXED ADDRESSING 


PAGE MODE OHLY 

PC 

4 * 

Instruction 

+ 

m 


block page 


iiiTWigw'i T 


11111 n 


012345 678 9 10 11 12 13 14 15 16 17 

0 1 1 § 21 3 [ 4 ^ 14 |* 5 | 17 j 


EFFECTIVE ADDRESS 


MOTE that the effective address may be anywhere in 128K® 

Care must be taken not to address non-existent memory 
(this includes negative addresses)® 



INDIRECT INDEXED ADDRESSING 


PAGE MODE ONLY 

PC 

Instruction 


PC 

nm 

| | j | | | | | j j 1 | | | 

+ 

0 12 

3 4 5 6 7 8 9 10 U ” 12 B M 15 16 17 

Pointer Word 

|HiyyUUyL3[JLl^L]QUElEjE]| 

4* 

0 12 

3 4 5 6 7 8 9 30 S 12 13 14 15 16 17 

XR 

mm 






EFFECTIVE ADDRESS 


block page 



Address of Pointer Word 


NOTE that the effective address may fee anywhere in 128K. 

Care must be taken not to address non-existent memory 
(this includes negative addresses)® 





AUTOINCREMENT ADDRESSING 


PAGE MODE and BANK MODE 


Instruction 


address 

10-17 



Auto- 

£ 85858 * 10 - 17 ) 

+ 

000001 


0 12 3 


6 7 8 9 10 11 12 13 14 15 16 17 


00000 0 00000000000 
'EFFECTIVE ADDRESS 


NOTE that the effective address may be anywhere in 128K. 

Care must be taken not to address non-existent memory 
(this includes negative addresses)® 
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J ut©- 
ncreipent 
©cation(10-17) 

4- 

XR 

+ 

000001 

.. ...~~. ~wwWfTVE mmms 

NOTE that the effective address may be anywhere in 128K @ 

Care, must be taken not to address non-existent memory 
(this includes negative addresses). 









SUBROUTINES 


Whati A section o£ code 5 usually performing one task 9 that may 

be called from various points of the main program® 







How; The JMS instruction is used to enter subroutines® 

Recall that upon a JMS 

a) The updated PC is stored at the address specified in 
the JMS • 

b) The (specified address) +1 is now placed in the PC^ 
so that execution is picked up at the second location 
of the subroutine® 



Before JMS 

JMS MOVE 


After JMS 
JMS MOVE 

© 

© 


200 MOVE 


200 MOVE 101 



c ) Return to 
on 


calling program is effected via a 
first location of the subroutine® 


MOVE 0 


JMP* MOVE 

Passing Arguments - very often a subroutine has to process data 

contained in the calling routine® In order to 

do this the calling routine must pass this data 

or the address(es) of the data to the subroutine® 
This is called ^passing arguments®” 

There are a number of ways this can be done® Among them ares 

1) AC l passing arguments in CPU 

2) MQgXRjLR J registers 

3) trailing arguments; JMS SUB 

Arg 1 
Arg 2 
Arg 3 




4) Setting up a list of arguments and passing the 
address via (1), (2), or (3). 


LAC (LIST ADDRESS JMS 

JMC SUB LIST 

<£ 


LIST ADDRESS ARGl 
ARG2 


SUB 

ABUSES S 


ARGN 



PC15 High-Speed 
Paper-Tap® Reader Pune 


1.1 INTRODUCTION 

The PC 15 High-Speed Paper Tape Reader/Punch is used to input 1 perforated paper-tape programs into 
core memory, or to punch core memory programs or data on paper tape- Information is punched on 
8-channel fanfolded paper tape in the form of 6- or 8-bit characters at a maximum rate of 50 char¬ 
acters/second. Information is read at a maximum rate of 300 characters/second. The PC15 consists 
of a PC05 Paper Tape Reader/Punch with interface and control logic for using the reader/punch with 
a PDP-15. 

1.2 PAPER-TAPE READER 

1.2.1 Characteristics and Capabilities 

Data can be read from tape and transferred to the PDP-15, using the computer hardware read in logic 
or using program-controlled transfers. For hardware readin operation, the hardware readin logic 
supplies inputs for selecting the operating mode, starting tape motion, and implementing transfers. 

For program-control led transfers, the computer issues in put/output transfer (IOT) instructions that 
select the operating mode, advance the tape, and implement the transfer. To maintain a maximum 
rate of 300 characters/second, a new select IOT must be issued within 1 .67 ms of the last reader flag. 

If not, the reader operates start-stop and reads characters at a 25 character/second rate. The re¬ 
quirements for maximum character rate are described in detail in Programming Considerations, 

Paragraph 1 .4.1 . 

The reader interfaces with the automatic priority interrupt (API) facility, the program interrupt facility, 

and the input/output skip chain. For API operation, the reader is assigned API level 2; a unique entry 

address of 50 o is assigned to its service routine, 
o 

The reader contains a no-tape sensor and flag (character ready for transfer) circuits. If a no-tape 
condition is detected, the reader flag is set, end a program interrupt is Initiated whenever a reader 
select IOT is given. The states of the reader flag, the reader API 2 level, PI request and skip request 




devices are displayed on an indicator panel at the top of Cabinet H963E (Bay 1R). In addition, this 
panel displays the reader buffer contents and the I/O address (API unique entry address). These items 
and the reader controls are described in Controls and Indicators, Paragraph 1.2.3. 

Reader mechanical facilities include a right-hand bin for supply for tape being read, a left-hand bin 
for receiving the tape, and a feed-through mechanism to control passage of the tape info the receiving 
bin. A snap-action retainer on the feed-through mechanism facilitates simple loading of the tape. 

1.2.2 Operating Modes 

The PC15 reader operates in either an alphanumeric or binary mode. For program-con trolled transfers, 
the operating mode is selected by IOT instructions. For hardware readin operation, control logic in 
the reader automatically selects the binary mode. 

When alphanumeric mode is selected, one 8-bit character (in ASCII code) is read and transferred to 
the PDP-15 accumulator. In the binary mode, the reader reads three 6-bit characters (three frames 
with channels 7 and 8 ignored) from tape and assembles them info an 18-bit word for transfer to the 
accumulator. 


1.2.3 Controls and Indicators 

Two front panel controls are provided for the PC15 Paper-Tape Reader: ON LINE/OFF LINE and 
FEED. The ON LINE position places the reader under computer control. The OFF LINE position, 
which is used for loading paper tape, raises an out-of-tape flag and places the reader under local 
control. The indicators associated with reader operation are located on an indicator panel at the top 
of cabinet H963E (Bay 1 R). Table 1-1 lists the indicators and their functions. 


Table 1-1 

Indicators Associated with Paper-Tape Reader 


Indicator 

Function 

READER BUFFER 00-17 

Indicates the contents of the paper-tape reader buffer. 

API 2 RDR 

Denotes API level 2 is active as the result of a reader 
interrupt. 

I/O ADDRESS 

Indicates the unique trap address associated with I/O 
devices; address 50g for paper-tape reader. 

RDR FLG 

Denotes information has been read from tape and is 
available for transfer from reader buffer. 













•^*X 


Table 1-1 (Cont) 

Indicators Associated with Paper-Tape Reader 


Indicator 


Functi on 


PI RQ 


SKIP RQ 


Denotes one of the I/O devices (including pa per™ tape 
reader) handled by the BA15 Peripheral Expander has 
generated an interrupt request. 

Denotes one of the I/O devices (including paper-tape 
reader) handled by BA15 has responded to a skip IOT 

instruction „ 


1.2.4 Tape Formats 

The format of the perforated paper tapes for the alphanumeric (ASCII usage) mode is shown in Figure 1-1. 
In addition, tape channels are related to the PDP-15 accumulator stages. The leader and trailer por¬ 
tions of the tape are used to introduce or conclude a paper-tape pregram. Only the feed hole is 
punched for the leader/trailer portions. Note that each character is read by one IOT instruction. 




0 

□ 

0 

0 

4 

0 

0 

0 

8 

9 

10 

0 

12 

13 

14 

15 

16 
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CHANNEL 

ACCUMULATOR 

CHANNEL 


TAPE CHANNEL 
8 7 6 5 4 32 1 


LEADER 

(FEED HOLE ONLY) 


DIRECTION 
OF TAPE 
MOVEMENT 



e=HOLE POSITION 
®= HOLE PUNCHED 

18-0232 


Figure 1-1 Tape Format and Accumulator Bits (Alphanumeric Made) 









The paper-tape format for binary mode using hardware readin (HR!) is shown in Figure 1-2 as well as 
the relationship of accumulator stages for the 18°=b?f word* Note that only the feed hole is perforated 
for the leader/frailer portion and that channel 8 is always punched in the program portion of the tape* 
Any character without hole 8 punched will be ignored* Channel 7 punched in the last character in¬ 
dicates the last 18-bit instruction is to be executed by the computer. This instruction can half ma¬ 
chine operation or can transfer machine control to another part of the program. When using this format, 
channel 7 must be punched using the alphanumeric mode. 


1 ,2.5 Instructions 

The PDP-15 IOT instructions used for program-controlled loading of paper-tape data are listed below. 
Refer to Volume 1 of this handbook for IOT instruction format. 


Mnemonic 

Octal Code 

Operation Performed 

RSF 

700101 

Skip next instruction if reader flag is a 1. 

RCF 

700102 

Clear reader flag. Read reader buffer. Inclu¬ 
sively OR contents of reader buffer with AC, 
and deposit result in AC. 

RRB 

700112 

Read reader buffer and clear reader flag. Clear 
AC and transfer contents of reader buffer to AC, 

RSA 

700104 

Select alphanumeric mode and place one 8-bit 
character in reader buffer. Clear flag before 
character is read from tape. Set reader flag to 

1 when transfer to reader buffer is complete. 

RSB 

700144 

Select binary modes. Assemble three 6-bit 


characters in reader buffer. Clear reader flag 
during assembly and set flag when assembly is 
complete. 


The paper-tape reader responds to an input/outpuf read status (IORS) instruction by supplying the status 
of its device flags and no-tape flags to the accumulator. The reader device flag (reader interrupt) 
interfaces with bit 01 of the accumulator. The reader no-tape flag interfaces with bits 08 of the 
accumulator. 


1.2.6 Functional Description 

The PC15 reader consists of an electromechanical tape feed system, a light source and photo cells for 
sensing tape perforations, a buffer register for storing and assembling data, and control logic for com¬ 
puter interface, tape advance, and transfer operations. These circuits can be used with the PDP-15 
hardware readin logic, or can be used for program-controlled transfers, as described in the following 
paragraphs. 








1 .2,6,1 Hardware Readin Operation - The PC 15 reader can be used with PDP-15 hardware readin 
logic to load programs from paper tape at a rate of 300 characters/second, For this operation, the 
desired tape is Installed in the high-speed reader, and the program loading address Is selected, using 
the console ADDRESS switches. The console RESET key is then pressed to initialize the computer and 
paper-tape reader. A readin operation is started by pressing the READIN key on the console. 

With this key action, a Readin (RI) condition is stored in the reader, and the binary mode is selected. 
The reader then advances the tape, reads three characters from tape, assembles them into an 18-bit 
word in the reader buffer, and signals the hardware readin logic with a program interrupt. The hard¬ 
ware readin logic, in turn, transfers the 18-bit word to the accumulator under l/O processor and com¬ 
puter timing. The word is subsequently loaded into core memory by forcing a DAC instruction. The 
first 18-bit word is stored at the address specified by the console ADDRESS switches. Subsequent 18- 
bit words are stored in sequential memory locations. 

The readin operation continues until a perforated hole 7 is detected. This condition is inserted in the 
last character of the last 18-bit instruction. When this condition is detected, the reader supplies the 
hardware readin logic with a skip request. As a result, the hardware readin logic causes the last in¬ 
struction to be loaded into the Memory Input register for execution. This instruction can halt machine 
operation (HALT) or can transfer program control to another part of the program (JMP). When using 
the readin feature with the MP15 Memory Parity option, the last instruction on the paper tape (which 
will be executed by the processor) will not be written into the next sequential memory location. That 
location, however, will be loaded with data that may contain wrong parity. Therefore, that location 
should be re-stored by the program before an attempt is made to read from it. Otherwise, a parity er¬ 
ror wi 11 occur. 

1.2.6.2 Program-Controlled Operation - The PC15 reader operates in the binary or alphanumeric 
mode depending on the select IOT instructions issued by the computer. On decoding a reader select 

alphanumeric (RSA) mode IOT (7001 04g) , the reader advances the tape one character, loads this char¬ 
acter into the reader buffer, and sets the reader device flag. The reader then signals the computer 
that data are available by providing a reader interrupt to the API or PI, or by responding to an RSF IOT 
instruction. If the API facility is being used, program control is transferred to the reader service rou¬ 
tine where the computer services the request, and an RCF (7001020) or RRB (7001120) instruction is 
issued. If the API facility is not being used, the computer issues an RSF instruction, and the reader 
returns a skip request whenever its flag is set. The skip request causes the next instruction (normally 
a JMP .-1 in wait loops) to be skipped so that the character can be transferred to the accumulator by 
issuing an RCF or RRB instruction. The RCF or RRB instruction transfers the reader buffer character to 
the I/O bus and loads it into the least significant bits (10 through 17 for 8-bit alphanumeric character) 
of the accumulator. The character is subsequently stored in a core memory location designated by the 
program. The read reader buffer (RRB) instruction also clears the reader flag for the next read opera¬ 
tion . 

For binary mode operation, the computer issues a reader select binary (RSB) mode instruction (octal 
700144). On decoding this instruction, the reader clears its device flag, advances the tape three 




characters, reads these characters from tape, and assembles them Into an 18-bit word in the reader 
buffer. The reader also counts the number of characters with hole 8 punched read from tape and, when 
a count of three is reached, generates an interrupt request. The control functions for transfer of the 
18-bit word to the accumulator is the same as that described for the alphanumeric mode. 







1.3 PAPER-TAPE PUNCH 
1 .3.1 Characteristics and Capabilities 

The PC 15 paper-tape punch consists of a tape feed system, a mechanical punch assembly, a buffer 
register, and control logic for mode selection and activation of the tape feed and punch mechanism. 
Tape advance, mode selection, and transfer of information to the punch are controlled by IOT in¬ 
structions. Tape is perforated at a rate of 50 characters/second. When the punch is selected by an 
IOT instruction, data from the PDP-15 accumulator (AC 10-AC 17) are transferred to the punch buffer. 
Then, without further inputs, a character is perforated on tape. 

The punch contains a device flag that denotes punch status for transfers. This device flag interfaces 
with the PI facility and i/O skip chain. The status of the punch flag is displayed on an indicator 
panel at the fop of Cabinet H963E (Bay 1R). An out-of-tape switch is located on the punch mecha¬ 
nism. This switch initiates action that stops punch operations when approximately one inch of un¬ 
punched tape remains. 

Power for the punch operation is available whenever the PDP-15 power is on. The punch runs when 
selected by an IOT instruction or when the FEED switch is pressed. 

Punch mechanical features include a magazine for unpunched tape and a container for tape chad. 

Both are accessible when fhe readei—punch drawer is expended from fhe cabinet. 


1.3.2 Operating Modes 

The PC 15 Punch operates in the alphanumeric or binary mode as designated by IOT select instructions. 
One of these instructions is required for each character punched for mode change. In the alpha¬ 
numeric mode, an 8-bit character (in ASCII or modified ASCII code) is punched for each accumulator 
transfer to the punch. For the binary mode, one 6-bit data character is perforated for each accumu¬ 
lator transfer. Hole 8 is always punched, and hole 7 is never punched. Three of these characters, 
however, form one computer word for readin operations. 



1 .3.3 Controls and Indicators 


The PC 15 Punch has a front pane! FEED control, This control is used to advance the tape from the 
punch as required for leader or trailer. The punch also has one indicator (PUN FLG) directly asso¬ 
ciated with its operation. This indicator, located on an indicator panel at the top of Cabinet H963E 
(Bay 1R), indicates the status of the device flag and, shows that the punch is available for a punch 
operation when lit. The punch also shares the PI RQ and SKIP RQ indicators on this panel with other 
I/O devices. 

1 .3 .4 Tape Formats 

Tape formats are shown in Figures 1-1 and 1-2. 

1.3.5 Instructions 

The PDP-15 IOT instructions used for punching of paper tape under program control are listed below. 
Refer to Volume 1 of this handbook for IOT instruction format. 


Mnemonic 

Octal Code 

Operation Performed 

PSF 

700201 

Skip next instruction if punch flag is a 1. 

PCF 

700202 

Clear punch flag and punch buffer. 

PSA 

700204 

Select alphanumeric mode and punch one char¬ 
acter. Set punch flag when punch is complete 

PSB 

700244 

Select binary mode and punch one 6-bit char¬ 
acter. Set punch flag when punch is complete 


The punch responds to the IORS instruction (Volume 1, Paragraph 3.7.1) by supplying the status of its 
device flag and no-tape flag to the accumulator. The device flag interfaces with bit 02 of the accu¬ 
mulator, and the no-tape flag interfaces with bit 09. 

1.3.6 Functional Description 

The PC15 Punch operates in the alphanumeric or binary mode, depending on whether a PSA or PSB 
instruction is issued. When one of these instructions is decoded, information is loaded into the punch 
buffer from bits 10 through 17 of the accumulator and is punched onto tape. During the interval the 
punch operation is in progress, the punch flag is cleared to indicate the punch is busy. When the 
punch operation is complete, the punch flag is set to 1 to indicate it can accept another input 
character . 




The operating sequence for punch operations normally begins with a PSF instruction to test the device 
flag. If the device flag is I, a skip request is returned to the computer, and the computer issues a 
PCF instruction. This instruction clears the device flag and the punch buffer. The computer then 
issues a PSA or PSB instruction. On decoding a PSA instruction, the reader loads the accumulator 
input into its buffer, advances the tape, and punches one character. For the alphanumeric mode 
channel 8 is punched as a function of bit AGIO. For the alphanumeric mode channel 7 is perforated 
as a function of bit AC 11 . After the character is punched, the reader sets its device flag, and the 
process is repeated. This operation, performed by the PCF and PSA instructions, can be combined 
by microprogramming the two instructions to form octal 700206. 

The same principles are used for punching a binary character; however, a PSB instruction is used in 
place of the PSA instruction. On decoding a PSB, the punch perforates channel 8 and inhibits the 
punching of channel 7. The remaining six channels are punched as a function of ACI2 through AC 17, 
and represent one 6-bit character of a computer word. 

1.4 PROGRAMMING CONSIDERATIONS 

1.4.1 High-Speed Paper-Tape Reader 

To use the reader at the transfer rate of 300 cps, a select IOT (RSA or RSB) must be issued within 
1 .67 ms after each flag. This action is required because a 40 ms reader stop delay is present. When 
this delay is activated, it overrides the select IOT input and subsequently stops the tape. Thus, if a 
new select IOT is not received within 1.67 ms of the setting of the flag, the reader operates start-stop 
and reads characters at 25 cps rate. No data is lost. 

The RSA (octal 700104) and RCF (octal 700102) can be microprogrammed to form an octal 700106 in¬ 
struction. This instruction reads the character, transfers the character to the accumulator, and ad¬ 
vances the tape in one operation. An RSF (octal 700101) and RRB (700112) cannot be microprogrammed. 

1.4.2 High-Speed Paper-Tape Punch 

Channel 7 can be punched using only the alphanumeric mode. Therefore, when punching the last 
character of a tape for hardware readin operation, the last character must be punched in the alpha¬ 
numeric mode. 

The PCF instruction can be microprogrammed with a PSA or PSB instruction to form octal 700206 or 
700246. This instruction clears the punch flag and buffer, selects the applicable mode, loads the 



punch buffer, advances the tape, and perforates the character on tape* After completing the punching, 
the punch flag is set to denote the punch can accept another character. Microprogramming the FCF 
and PSF instructions is not allowed. 

1.5 PROGRAMMING EXAMPLES 
1.5.1 Paper-Tape Reader/Punch Handlers 

All PDP™ 15 Systems are supplied with standard I/O device handler subroutines for the paper-tap® 
reader/punch hardware. For PDP-15/10 Systems with 4K core, the COMPACT software includes 
paper-tape handler routines such as PTLIST and PTDUP. The Basic I/O Monitor, supplied with 
PDP-15/10E Systems with 8K core or greater, include standard I/O device handlers for the high-speed 
paper-tape reader and punch. These standard device handlers operate in systems with or without API 
and are upward compatible with all other monitors on the PDP-15/20 Software System. Complete in¬ 
structions on use of standard paper-tape reader and punch handlers and their modification for special 
applications are provided in the PDP-15/10 Software System Manual, DEC-15-GR1A-D. 


1.5.2 Paper-Tape Reader Programming Example 

The following subroutine illustrates the use of programmed IOT instructions to read a group of binary 
words from paper tape. Twenty-five 18-bit words are read and stored in a table starting at ADDRESS. 

NOTE 

This example is for instructional purposes only and is not 
to be considered a complete, fully tested software system 
segment. 


SUBRTE 0 

LAW 

-31 

/25 DECIMAL WORDS 

DAC 

WDCNT 


LAC 

(ADRESS 


PAX 

READLP IORS 

AND 

(1000 

/IS THE PAPER TAPE READER EMPTY? 

SZA 


AES IF NON-ZERO. 

JMP* 

SU BRTE 

/EXIT.. ..ITS EMPTY 

RSB 


/NO. START READING A WORD. 

RSF 

JMP 

.-1 

/WAIT FOR IT. 

RRB 


/GET IT FROM HARDWARE BUFFER. 

DAC 

0,X 


AXR 

1 

/POINT TO NEXT LOG AT ADDR. 

ISZ 

WDCNT 

/HAVE 25 WORDS BEEN READ? 

JMP 

READLP 

/NO...CONTINUE LOOPING. 

JMP* 

SU BRTE 

AES. EXIT. 



1 .3.3 Paper-Tape Punch Programming Example 


The following subroutines illustrate some paper-tape punch programming considerations. Their purpose 
is to unpack successive 6-bit ASCII characters from a table, convert them to 7-bit ASCII, and punch 
them on paper tape. The starting address of the table is placed in a location named ADDRESS. The 
number of words in the table is placed in WORDCNT. After these parameters have been deposited, 
the subroutines are entered by a JMS to PNCHOUT. 


NOTE 

This example is for instructional purposes only and is not 
to be considered a complete, fully tested software system 
segment. 







PNCHOUT 


NXTWORD 


NXTCHAR 


PPCHAR 


0 


LAC 

WORDCNT 

/THIS INITIALIZATION 

TCA 


/ROUTINE STORES 2'S 

DAC 

WORDCNT 

/COMPLEMENT WORDCNT 

CLX 


/AND CLEARS XR. 

LAW 

-3 

/SET UP A COUNTER FOR 

DAC 

COUNT 

/3 CHARACTERS. 

LAC 

ADDRESS,X 

/USE XR TO GET EACH WORD. 

RAL 


/AC HOLDS 3 6-BIT ASCII 
/CHARS. ROTATE INTO LINK. 

RTL 


/ROTATE WORD 6 PLACES 

RTL 


AHRULINK. THE NEXT 

RTL 


/6-BIT CHAR. IS IN AC12-17. 

DAC 

SAVE AC 

/SAVE REMAINING CHARS. 

AND 

(77) 

AHIS ROUTINE CONVERTS 

TAD 

(40) 

AHE 6-BIT ASCII IN AC12-17 

AND 

(77) 

/TO 7-BIT ASCII IN 

TAD 

(40) 

/AC11-17. 

JMS 

PPCHAR 

/READY TO PUNCH CHAR. 

LAC 

SAVEAC 

/RESTORE SHIFTED AC. 

isz 

COUNT 

/LAST CHARACTER? 

JMP 

NXTCHAR 

/NO. DO NEXT CHARACTER. 

AXR 

1 

/POINT TO NEXT WORD. 

ISZ 

WORDCNT 

/LAST WORD? 

JMP* 

PPASCII 

/NO. DO NEXT WORD. 

JMP* 

PNCHOUT 

/YES. RETURN TO PROGRAM. 

0 

DAC 

STORE 

/SAVE CHAR. FOR ’NO TAPE' 
/TEST. 

IORS 


/LOAD PUNCH STATUS INTO AC 

AND 

(400) 

/TEST NO PUNCH TAPE BIT. 

SZA 


/SKIP IF TAPE OK. 

JMP 

EOT 

/GO TO END OF TAPE RTE. 




LAC 

STORE 

/LOAD AC WITH CHARACTERS 

PSA 


/SELECT ALPHA MODE & PUNCH 

PSF 


/Wait for flag. 

JMP 

.-1 


PCF 

JMP* 

PPCHAR 

/RETURN TO SUBPROGRAM. 


1.5.4 Programming With API or PI 

The standard device handlers for the high-speed paper-tape reader and punch include complete inter¬ 
rupt subroutines for both API and PI service. Details on how the Program Interrupt Control (PIC) skip 
chain and the Automatic Priority Interrupt (API) channels are set up and provided in Part III of the 
PDP-15/10 Software System Manual. The following example of a hypothetical interrupt service sub¬ 
routine is provided for general understanding of interrupt servicing. 

NOTE 

This example is not a complete, fully-tested interrupt 
service handler. 


1.5.4.1 Program Interrupt Example 


PI 


SKPCHN 


RSB 


/ISSUE READER SELECT 
/BINARY IOT WITH PI ENABLE. 
/REST OF USER PROGRAM. 

.LOC 

0 


0 


/SAVE PC, LINK, EXTEND MODE 
A MEM. PROT. BITS AT LOCO. 

JMP 

SKPCHN 

/GO TO SKIP CHAIN. 

SPFAL 


/POWER FAIL FLAG TEST. 

SKP 


/GO TO NEXT TEST. 

JMP* 

INT6 

/GO TO POWER FAIL SUBRTE. 

RSF 


/PAPER-TAPE READER DONE? 

SKP 


/GO TO NEXT TEST. 

JMP* 

INT2 

/GO TO PTR INTERRUPT. 

PSF 


/PAPER-TAPE PUNCH DONE? 

SKP 


/GO TO NEXT TEST. 

JMP* 

INT3 

/GO TO PTP INTERRUPT. 


/OTHER TESTS 


/INT6, INT2, AND INT3 ARE PART OF A TABLE 

/OF INTERRUPT SERVICE ROUTINE STARTING ADDRESSES. 

/AN EXAMPLE OF INT2 FOLLOWS: 



INT2 

PTRPIC 


PTRP1C 

DAC 

PTRAC 


LAC* 

(0 


1.5.4.2 API Example 
RSB 


.LOG 50 
JMS PTRINT 


PTRINT 0 

DAC PTRAC 
LAC PTRINT 


/15-BIT ADDRESS OF PAPER 
/TAPE READER SERVICE 
/ROUTINE. 

/OTHER I/O SERVICE ROUTINE 
/POINTERS 

/SAVE AC. 

/SAVE PC, LINK, BANK MODE 
/AND USER MODE IN PTROUT. 

/REST OF INTERRUPT HANDLED. 


/SELECT READER IN 
/BINARY MODE 

/REST OF INTERRUPT 
/HANDLED. 


/PAPER TAPE READER 
/API ENTRY LOCATION 


/API ENTRY. SAVE AC. 
/SAVE PC, LINK, BANK 
/MODE & USER MODE BITS. 
/ 


DAC 


PTROUT 





Pa per tA PE LOTS 

READER 




% PUNCH 

OUTPUT 




ALPHA¬ 

NUMERIC 





Channel 8=1 
Channel 7=0 




PAPER TAPE FORMATS 


Assembled Programs May Appear In Two Formats 


Hardware 

Readin 

Format 

X® Loaded using Hardware 
control logic 

2® Output from assembler 
when use ^FULL 

3 @ Load address supplied 
by DATA SWITCHES 
on CONSOLE 

4o All words loaded 

sequentially - no way 
to change where 
loaded 

5® Read continues until 
a frame with CHANNEL 7 
punched is detected e 


Absolute 

Format 

1® Loaded using 
Absolute Loader 

2 a Output from assembler 
when use ©ABS 

3 e Load address for each 
block supplied as first 
word in data block 

4o All words loaded 
sequentially until 
new load address 
supplied by data block 

5„ Read continues until 
START BLOCK® 




Programming tapes are supplied in one of two formats: 

1 . HRI - Hardware read-in mode (.FULL assembly parameter) 

2. BINARY OR ABS - (.ABS assembly parameter) 


HRI tapes consist of 18 bit data and instructions punched in binary 
mode (PSB), which are loaded in sequential memory locations via the 
Hardware Read~In feature. The last word is an instruction which is 
to be executed when read (i.e. HLT or JMP). The last word is in¬ 
dicated by channel #7 being punched in the last frame of that word. 

The load address is supplied by the address switch register. 


ABS or Binary, paper tapes consists of 3 basic parts: 

1. ABS Loader Program punched in Hardware Read-In Format 

2. Data Blocks (there may be more than one) 

3. Start Block (there is only one) 

The ABS Loader (Absolute Loader) is a program in HRI format. 

When read via the Console "Read-In" Key, it is loaded and started 
automatically. While executing, the Absolute Loader reads and 
loads the remainder of the tape. The Absolute Loader expects the 
tape it is reading to have a particular format containing Data 
and Start Blocks. 


DATA BLOCK - Consists of 3 control words (Data Block Header) fol¬ 
lowed by the data to be loaded: 

1. Load Address 

2. Word count (not exceeding 25 and stored as a 2 ! s complement 
negative number) 

3. Checksum 


DATA 


START BLOCK - A two word block at the end of the tape.^ It is 
distinguished from a Data Block because bit 0 of 
the first word is a one (i.e. channel #6 in the 
first of 3 frames is punched). 

1. Starting address (777777 means "HLT” rather than "JMP 
t o some 1©cation) 

2. Dummy word (not used) 
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FULTST SRC 


00100 

00100 740040 BEG 

00101 750004 

00102 340111 

8S!@3 040112 

80104 740040 

88105 750084 . 

00106 548112 

08107 758040 

00110 75i04I 

001 1 1 000001 ONE 

000000 

SIZE=8®I13 










mim 

00180 

00181 

00182 

00103 

00184 

80105 

00106 

00107 

88110 

881 12 


740040 

750004 

340112 

040111 

748040 

758084 

5401 1 I 

750040 

750041 

008800 

0i®00! 


BEG 


SiZE=@8!13 


,eni 


NO ERROR LliES 


*LOC 180 


HIT— 

o o q © 

LAS —__ 

o 

© ® 

® ®@# 

TA1 (1 

o 

• 

« .':v 


# 

• *- © 

sr 

@ - 
9 ® 

iflb Itnrff 

i n t . —. 

# i4<t 

• 

9 © - 

HL 1 ■——- ■ 

ISTimw 

® 

© 

LAS 

SAl TEMP-- 

T © '© in 
m 

© @ 


@ 

CLA IHLT*——' ~~~ 

© ® 

CMA!CLA!HLT--^ 

1 "¥¥¥ 
© 


© 

@©® 


IDO 

YOU 

SEE 


THE 

PROBLEM 

IS 

WHEN 

THIS 

IS 

LOADEi 
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ABSVER SRC 


00100 
00100 
00101 
00102 
00103 
00104 
00105 
00106 
00107 
00110 

001 12 


740040 BEG 

750004 

340112 

040111 

740040 

750004 

5401 11 

750040 

750041 

000100 

000001 

SIZE = 001 13 







DOS-15 COOKBOOK 


Forma tt ing Dec tape s 

The format generator tape is read in under HRI mode 

1 . Set the address switches to 17720 (some tapes may call for 
17700). 

2. Depress STOP, RESET, READIN * 

Conversation program begins. Place Dectape on a unit other 
than unit 0 . Don't take up more than 2 wraps. Follow directions. 

Note: Before you can use the tape, you must go to PIP to clear 

out the directory. 

$PIP 

DOSPIP VXX 
>L W TT 4- DTI 
N«DT2 


Loading DOS Into a Cold Machine 

h Mount DOS restore tape #1 on Dectape transport 
Set rotary switch to 1 
Set remote switch 
Set write lock 

2. Load pos save-restore paper tapethru high-s pe ed reader 
Place tape in reader 

Set address switches to 17720 
Depress STOP, RESET and then READIN 

The paper tape is read in and a conversational mode program begins 

INPUT s DT; 

UNIT i \) 

OUTPUT 2 

The program will tell you when to mount the second tape. 

At the completion of loading, DOS has been placed on the disk. 

3. To bring the resident Monitor into cores 

Set address switches to X7637 where X = 1 for 8K 

3 for 16K 
5 for 24K 
7 for 32K 

Place the DOS bootstrap tape in the reader (usually on the 
same tape as the DOS SAVE & STORE paper tape) 

Depress STOP, RESET, then READIN. 


DOS announces itself. 









mmM Notes The BOOTSTRAP stays in high core unless you cleverly 
manage to destroy it. 

To get the monitors 

(a) Control C (echoed as fC) 

(b) Set address switches to X7646 where X is same value as 
befores STOP , RESET , START 

(c) Set address switches to X7637 and read in bootstrap again 

(d) The whole DOS restore procedure again 

(e) Call a maintenance person 


pip 

- To call PIP $PXP 

DOSPIP VXX 

y > 

To list the directory from the disk on the teletype! 

TT DKgj 

To list the directory from the Dectape on unit 2 on the line 
printer: 

^Lft/LP 4- DT2j 

To transfer a file from the disk to dectape: 

^■T&iDTl DKwTESTFL SRC^j 

>TwDT2^FILEA BIN 4- DK^PILl^BIN; 


MACRO 

■*“ “To call MACRO $MACRO 

MACRO VXX 
T'BN <4™ FILENMj 

^OR ALTMODE 


To load a program generated under *ABS or 0 ABSPi 

1, Place tape in reader 

2. Set address switches to 17720 

3 . Depress STOP, RESET then READIN„ 

This causes the absolute loader to be loaded <> It starts 
automatically and in turn reads in the rest of the tape--that 
is, your program. 



DOS -1 5 V3A000 
$L 

******************************************************************* 
EXAMPLE OF WRIIING,ASSEMBLING AND LOADING A RELOCATABLE PROGRAM 
********************>M<********************************************* 

SEDIT 


EDITOR V3A000 
>OPEN SAMPLE 

FILE SAMPLE SRC NOT FOUND. 
INPUT 

LAC (707070 

HLT 

®E ND 

..EDIT 

VCLOSE 

EDITOR V3A000 
>0PEN SAMPLE 
EDIT 
>N 

>C //START/ 

‘’"START LAC (7070 70 
-L .E ND 

®END 

>A START 
>P 

.END START 

»E XIT 


'-‘■QOS-I 5 V3A000 
IA LP - 12 

$A DK ~!3 

"SK ON 


$MACR 0 


BMACRO-15 V3A000 
>B L*-SAMPLE 
END OF PASS 1 

SIZE = 00003 NO ERROR LINES 

BMACRO-15 V3A000 

>tC 


...DOS-I 5 V3A000 
'.LOAD 

BLOADER V3A000 
>P*-SAMPLE 

P SAMPLE SRC 77634 
tStS 


f»ASE I 8AHPII S»C 

mm 0 R 800002 R START 

mm i r 7$>mm a 
00MM P 

0100*2 R 707070 A *L 

SIXE®00003 


LAC (70707© 
HLT 

a END START 
NO ERROR LINES 




REAL TIME CLOCK 


References? Volume 1 Processor Handbook 6-42 

System Reference Manual B-14 


The Real Time Clock option provides a user with time reference 
capability for accounting purposes 9 periodic interrupts and interval 
timing• The clock produces clock pulses at the rate ofi 

or a) 60 times a second (every 16.7 as) for 60 Hz systems 
b) 50 times a second (every 20 ms) for 50 Hz systems 
(the standard clock works off the line frequency—-other clocks are 
available to produce clock pulses at user defined rates). 

When the clock is enabled (CLON ), every clock pulse generates 
a request for a break at the completion of the current instruction® 

When the break is granted by the CPU, the content of memory location 
000007 is incremented by 1. Location 000007 is the clock counter 
register® As long as the clock is enabled, the process of location 7 
being incremented at each clock tick continues® 

When the content of location 7 overflows (i. e. is incremented 
from yyyyyy to Q00000), the clock flag is set to 1. This condition 
may be checked for by the use of a Skip I0T (CLSE), Note also that 
the clock flag is interfaced to the PI and API systems so that if 
interrupts are enabled when the clock flag is set, an interrupt 
request will be made® 

Three I0T instructions are associated with the clocki 

CLON 700004 -Clock On 

-Enable the clock...increment 

location 000007 every clock tick 
-Clear the clock f s flag 

CLSF 700001 —Skip on Clock Flag Set®©»the next 

instruction is skipped if the 
clock® s flag is set 

CLOF 700044 -Clock Off 

-Disable the clock® e@ do not increment 
location 000007 
-Clear the clock 9 s flag® 

Since the clock counter register is memory location 000007, 
its contents may be modified by a programs A standard technique for 
using the clock is to preset the contents of location 7 to the 
complement of the desired time count (in ticks) and then to enable 
the clock (and the interrupt system if interrupts are to be used)® 

The clock flag will be raised (and an interrupt occur) at the end of 
the specified time period 0 For instance, to raise the flag afteri 

1 second, set location 000007 to 777704 (-60, rt =-74 o ) 

XO o 

5 second^set location 000007 to 777324 (-300, n ®-454 0 ). 

. , 10 8 
Notice that it is the 2 @ s complement that is used. This example and 
the following ones assume 60 ticks per second for the clock® 



REAL TIME CLOCK 


To check for an interval of 1 second toy cheeking the clock 6 s 
flag, the following sequence can be tasedt 


/14 ticks « 1 second 

/or DAC* (7 if program is not in page 0 
/ or bank 0 . 


LAW -74 
DAC 7 


CLON /enable clock—start incrementing 

CLSF /check for clock overflow 

JMP .-1 /not yet 

next instruction /get here after 1 second 


To check for an interval of 1 second via interrupts under the 
PI system, the following sequence may be usedi 

©LOG 0 
0 

JMP* ,+1 
TIMERT 

/Main Routine 

©LOG 102G0 


© 

LAW -74 
DAC* (7 
CLON 
ION 


/set clock for 
/©Oio ticks 

/enable clocksclear flag 
/enable PI interrupts 




© 


continue with 1 second®s worth of program 


©LOG 20500 

TIMERT DAC ACSAVE /save AC as it was at time of interrupt 

© 

l process clock interrupt—this may involve resetting 

• location 7 or even disabling 

l the clock 

© 

© 

LAC* (0 /pick up the return address from location 0 

DAC RETURN# 

• other instructions are necessary here so that when we 

• leave TIMERT the system looks as it did before the 

l interrupt occurred• 

/go back t© where w@ were interrupted 


W* RETURN 




REAL TIME CLOCK 


To cheek for an interval of 1 second via interrupts under the 
API system^ the following sequence may be usedi 


8 L0C 2 
TIMER 

@LOC 51 
JUS* 2 

,LOC 10200 

© 

© 

0 

LAW -74 
DAC* . (7 
CLON 

LAC (400000 
ISA 


/address of clock routine 


/set clock counter to -60 ticks 

/enable clocksclear clock flag 

/enable interrupts 
/from the API system 


© 

© 

© 

© 

© 


continue with 1 secondworth of program 


.LOG 20500 
TIMER 0 

BAG ACSAVE# /save AC as it was at time of interrupt 

& 

l process clock interrupt 
© 


other instructions are necessary here so that when we 
return to the interrupted routine # the system looks as 
it did before the interrupt occurred• 


JMP* TIME 


/go back to where w@ were interrupted 


REAL TIME CLOCK 


NOTES - 

1. The clock continues to count up from zero after overflow 
occurs. At overflow detection* however* the clock counter is 
usually reinitialised or the clock is disabled 

2 8 To enable the clocki 

Use the CLON instruction (make sure the console clock 
clock switch is OFF—front downj if the console is locked 
then CLON will enable the clock no matter what -position 
the console clock switch is in). 


3 @ To disable the clocki 

a) Use the CLOP instruction 
or to) Turn the console CLOCK switch ON (rear - half 
depressedi this will have an effect only if 
the console is not locked)• 

4» Depressing the RESET switch on the console clears the 
clock®s flag and disables the clock* 




PAGE 


BUTIN SRC 


PROGRAM TO MOVE AC LIGHTS CENTER*OUT,EACE ETC 

.TITLE PROGRAM TO HOVE AC LIGHTS CENTER.OUT.SACK 




10100 A 

10100 b 7§@m§ 

10101 a fS4§.m 

10102 A 709904 

10163 A 811148 
10104 A 80SI4I 
10109 A 810144 
10109 A 090142 


1010? k 010141 A 
1011® k 74008® A 
10111 A 090141 A 
10110 A 010140 A 
10118 A ? 4 §® 1 @ A 
10114 A 090140 A 
10110 k 0B0141 A 
1®1!6 A 


17 A 777704 
§§ A ®7®|4S 


STAftT 


SETUP LAC 


AGO 1010® 
XOF 

CLMCLL 


'TURN P% OFF 
^TUIN API OFF ill 


with Atmm 


SAC- LH# 

lac (000000 


/8BT SIT f ilCAUai ROTATE 

/SSFQiE 0I0PLAYIN0 

/||f BIT I® 0CCAU0S ROTATE LEP' 

mmm oisplahn® 


/MANURACTURE THE DISPLAYED ACCUMULATOR VALUE 

/BY TAKING EACH HALE ANB ROTATING IT IN THE APPROPRIATE 

/DIRECTION, THEN »XOR" THE HALVES ROR THE RULL VALUE, 


FORM 

HOVEL 


LAg LH 


LAC PH 


/SIT UP 
/ 

TIMER 


REAL TIME 5 CLOCiC e0UNTER»»LOCATXON 


mf 4 
> £7 


/SET UP COUNTER FOR 
/ONI SECOND INTERVAL 


EJECT 


■'“H 


79 



PAGE 


OUTIN SRC 


PROBRAM 


:8MT8 CENTER,OUT,BACK 6' 


/TURN CLOCK ON tRIRST TIME THRU! AND CLEAR CLOCK Ft,AS; 
/SUBSK8USNT USES OR «ClON» ARE TO CLEAR THE RLAS ONLY 
/THE CLOCK KEEPS ON C0UNT1N6 AFTER IT OVERPLOWS TO 0, 


Ifi A 310140 
188 A 7810044 
193 A 700801 
184 A 610123 


LAB BI8PL* 

CLQN 
asp 
JMP o«l 

/ 

/KEEP ROTATIN0 UNTIL THE AC840I5001 OS ABaPB148®. 
/WHEN AG EQUALS THESE VALUE® CHANSS THE DIRECTION 
/OR ROTATION. THIS IS DONE BY ACTUALLY CHAN8IN3 
/THE INSTRUCTION »RAL" TO *RAR* AND VICE VERSA. : 
/IS ACCOMPLISHED USINS THE "XOR" INSTRUCTION AS 
/RAL»740010 AND RAR*740080, SW1TCHINS BACK AND 
/FORTH IS JUST A MATTER OR X0RIN6 WITH 000030. 







nimm 

A 

m i 

OF COURSE 

10129 

A 

898146 

A 


¥ 

SAD 

C4ii8i| 

12128 

A 

010132 

A 



JMP 

CHANgl 

1212? 

k 

99814? 

A 



SAD 

(001480 

|®13| 

k 

f 41000 

A 



3KP 


12131 

k 

01210? 

A 



w 

FQ8H 

10132 

A 

218lli 

A 


CHANgg 

LAC 

HOVEL 

12133 

A 

gSi|S0 

A 



MGR 

(800030 

12134 

A 

881111 

A 



DAg 

HOVEL 

10135 

A 

assist) 

A 



XOR 

(000030 

10138 

A 

880113 

A 



DAD 

HOVER 

1213? 

A 

61110? 

A 


M 

w 

FORH 



780844 

A 


CLON»R00044 





A 


CL9P«?0808i 

S 




ililii 

A 


r 

® IND START 

10143 

A 

002000 

A 

*L 




10144 

A 

iiigii 

A 

*L 




l@|4§ 

A 

000007 

A 

*L 




10148 

A 

400091 

A 

*L 




|2|4? 

A 

mum 

A 

*L 




10180 

A 

000030 

A 

*L 






SIZE®10191 

N9 ESIPIQft L 2 N S8 



; i 


NOSLOB SRC 

NON 

SLOBAL SUBROUTINE 

CALLS 





j 

.TITLE NON.SLOBAL 

SUBROUTINE CALLS 



7@@4iJ 

4 

r 

T8M7804BI 




70040® 

A 

TL8®708^06 

4 



R 

immt 

A 

START 

I0P 



R 

1% 8514 

A 


ZSA«10 


8 0 8 0 2 

R 

7@®4|6 

A 

V 

TLS^|« 


MM3 

R 

380043 

R 

/ 

LAC CTABLI 


MM4 

R 

040048 

R 


OAC PTR# 


mm s 

R 

777778 

A 


LAW ®fi 


ii@@@ 

R 

i4i®41 

R 


OAC COUNT# 


0 0 0 0 7 

R 

188833 

R 


JHS 6RLF 


ii 

R 

020042 

R 

/ 

MORI 

LAC# PTR 


i®iii 

R 

180886 

R 


JNS PRINT 


mm2 

R 

180833 

$ 


JM8 CRLP 


001913 

R 

440048 

R 

/ 

XS1 PTR 


00014 

R 

440841 

R 


1SZ COUNT 


00015 

R 

§80@f® 

R 


JMP MORI 
.EXIT 


000§i 

R 

000060 

A 

i 

TABLE 

68 


@i®ga 

R 

000061 

A 


61 


mm2 

R 

000062 

A 


62 


0i@g3 

R 

800083 

A 


63 


0®@24 

R 


A 


64 


mms 

R 

000068 

A 

/ 

flg 


00026 

R 

iiiiii 

A 

/ 

PRINT 

i 


mm7 

R 

700481 

A 


TSF 


@0038 

R 

8@§@i7 

© 


JMP a as 1 


00831 

R 

7®040« 

A 


TLS 


ii@3g 

R 

@§@@26 

R 

7 

CRIP 

JMP* print 


00033 

R 

@0®@00 

A 

8 


00034 

R 

26001s 

A 


LAW IS 


00035 

R 

180026 

R 


JMS PRINT 


@®03@ 

R 

7608 IS 

A 


LAW 18 


Si® 37 

R 

180026 

R 


JM® PRINT 


0@®4g 

R 

820833 

R 

M 

JMP* CRIP 




000000 

R 

/ 

9 ind start 


00043 

R 

0ii@8@ 

R *L 





NO ERROR LINES 



PAGE 1 GLOBAL SRC . GLOBAL SUBROUTINE CALLS 

.TITLE GLOBAL SUBROUTINE CALLS 

/ 

790411 A T8F»?00401 

708488 A TLSP?8®4i0 

/ 

, uimi crle,print 

/ 

/ 


00000 

R 

700008 

A 


START 

IDF 

00001 

R 

703514 

A 



X8A+10 

0 §1 @ §■! 2 

R 

700416 

A 


j 

TLS+18 

00003 

R 

2f«3i 

R 


r 

LAC CTAlLi 

@®0i4 

R 

040087 

R 



0AC PTR# 

iiiig 

R 

777772 

A 



law *0 

00i@@ 

R 

i4iigg 

R 



DAD COUNTS 

08007 

R 

12003® 

E 



JHS*. CRLF 

10810 

R 

MiM? 

R 


i 

mnE 

LAC* PTR 

00811 

R 

12®§M 

I 



JMS# PRINT 

00018 

R 

180030 

c 


A 

JMS#_ CRLF 

80813 

R 

4400§7 

R 


/ 

III RTR 

@0il4 

R 

440080 

R 



X8Z COUNT 

®00|§ 

R 

mmi® 

R 



JHP MORE 







.EMIT 

00080 

R 

0010110 

A 


/ 

TA0LS. 

60 

80021 

R 

@0§®S1 

A 



il 

00182 

R 

mmm 

A 



18 

0®8i3 

R 

®iOT« 

A 



S3 

00024 

R 


A 



94 

®8®2§ 

R 

0»ii@8 

A 



SB 



mmm 

R 


/ 

e END START 


R 


E 

*E 



00031 

R 

000031 

E 




80038 

R 


R 






PAGE i CRIF SRC SUiiDUTINE TO PRINT OUT SR AND LF 

gTITLE IUIR8UT1NK TO PRINT OUT Cft AND l 

/ ' " 

% ©SUOiL CRUP,PRINT 


i@i«0 ft 000000 A CRUF 
10101 ft 760818 A 
08008 ft it®00i E 
ft 760818 A 
Pi®@4 ft 12i®»0 I 
«®08 R 620000- ft 

/ 

000000 A 

iii@@ ft 000006 E ^E 

8IZE100007 


LAN 215 
JM.g£_ PRINT 

law sit 

JNSjl PRINT 
JMPir CRLP 


®END 

NO ERROR LINE® 




mt 


JUSRQUTXNg TO PRINT SNAP ON TT 
©TITLE SUBROUTINE TO PRINT 
aiLOSL PRINT 


700401 A TSP»700401 

7®§4®6 A TLS@7i®4i§ 


®§§P!@ ft ®§0®i® A 
®®®®i r immi a 
§®®@2 ft 600001 ft 
00003 ft A 
00064 ft 6t®®§@ ft 


$ 

/CHARACTER 18 EKPgCTiD IN THE A6 
/ 

PRINT i 

?$F 

JMP ,»1 
TL8 

JMP# PRINT 


000006 A 

SI2|s««ii8 


©END 

NO SRROR LINES 




DOS-1 5 V3A000 
$A IP -12 

$K ON 

$MACRO 

3MACR0-15 V3A000 
>8LG^N0GL0B 
END OF PASS 1 

SIZE-30044 NO ERROR LINE 

tC 

DOS-15 V3A000 
$LOAD 

BLOADER V3A000 
»P«-NOGLOB 

P NOGLOB SRC 77573 
tSfS 
0 
1 

2 

3 

4 

5 


DOS"15 V3A000 
SMACRO 

BMACR0-I5 V3A000 
>8 L G *-G L OB A L 
rvn nr pass I 

SIZE-03033 WO ERROR LINES 

3MACR0-15 V3A000 
sQ L^CR LF 
END OF PASS 1 

SIZE=00007 NO ERROR LINES 

3MACRO-15 V3A000 

>bl^print 

END OF PASS 1 

SIZE=00005 NO ERROR LINES 


DOS-15 V3A000 
$LOAD 

BLOADER V3A000 
>P^GLOBAL,CRLF 9 PRINX 
P GLOBAL SRC 77604 
P CRLF SRC 77575 
P PRINT SRC 77570 
tS tS 


2 

3 

4 



5 



page 


AVGtOB SRC PROGRAM TO AVSRA3K DECIMAL VALUES 

a TITLE PROGRAM TO AVlRAfil DECIMAL VALUES 
/ . 

/ 

/ PROGRAM ACCEPTS DECIMAL VALUES PROM THE KfViOaROs 
/ SUMS THEM AND PRINTS OUT THE DECIMAL AVERAGE (GIVEN 
/ TO THE TENTHS PLACED ON THE TELEPRINTER. 

> USER SHOULD FOLLOW EACH VALUE WITH A COMMA 1 TERMINA' 
/ THE LINE WITH CR, FOR EXAMPLEl 3,18.89,4,(CR) 

/ 

/ eooopsoppcpcs ®®®®®®®®®®®®®®®®®®®®®®®®®®®®®®® 0 ®® 08 ®®® 1 




7§«@! 

A 

KSF*700S81 




700312 

A 

MBPiaiaia 




7i®4@0 

A 

TL8s70048« 

A 






F 

A 

.GLOSL CSLF 

$ii@« 

R 

f§7762 

A 

SESIN 

OB A 



R 

700000 

A 


XOF 


m 002 

R 

7®9§i4 

A 

A 

xsa* 

10 

®00®3 

R 

7®§416 

A 

r 

Tt$4> 

1® 

00004 

8 

140117 

R 

XNXT 

Qtn 

COUNT# 

aiiiS 

R 

|40ig® 

R 


DIM 

FINAL# 

@0S|0@ 

R 

100125 

E 


JNS# 

GULP 


R 

14012! 

R 

NXT 

QXH 

NUMB# 


R 

700301 

A 

/ 

NEMT 

K$F 


0®0U 

R 

600010 

R 


JMP 

8®! 

@0012 

R 

701312 

A 


KR0 


00013 

R 

§4®|g7 

R 


SAD 

C21B 

00014 

R 

000039 

R 


JHP 

ALLDUN 

00019 

R 

§4@15@ 

R 


SAD 

C854 

0 ® i 18 

R 

000030 

R 


JHP 

DUN 

00017 

R 

000131 

R 


AND 

C17 

00020 

R 

@40124 

R 

A 

OAC 

TBMP# 

60081 

r 

200121 

R 

9 

LAC 

NUMB 

00022 

R 

653122 

A 


HUL 


5§®0®3 

R 

g00@!8 

A 


18 


§§@24 

R 

04|i«8 

A 


UC0 

00@g§ 

R 

341124 

R 


TAD 

TEMP 

00@gi 

R 

04012! 

R 


DAC 

NUMS 


R 


R 

i 

JMP 

NEXT 

@§03® 

R 

200181 

R 

DUN 

LAC 

NUMi 

@0031 

R 

340180 

R 


TAD 

FINAL 

@@03g 

R 

®4@i£0 

R 

£ 

DAC 

final 

00033 

R 

44® 117 

R 

f 

v <& *2 
AH 4 

COUNT 

@0034 

R 

600007 

R 


JMP 

Htl 


/RUN IN PAGE MODE 
/TURN OFF PI 

/AND API INTERRUPT 8V9TEM8 

/INITIATE PRINT—-SET FLAG ' 
/COUNT" « OF VALUES 
/FINAL* SUM OF VALUES 
/ISSUE CR AND LF 
/TEMPORARY LOCATION 


/CR MEANS LAST VALUE 
/«,« 8EPARAT88 VALUE! 

/SET OCTAL NUMBER 


/RESULT SMALL..IN Ml 
/ADD ON LAST DIGIT 
/SAVE IN NUMB 


/BBT THIS VALUE 
/ADD it to THE SUM 


/KEEP track of how many walui 



00035 R 80011F R 

ALLDUN 

LAC COUNT 

«0036 R 040041 R 


OAC .43 

@0037 R 201120 R 


LAC FINAL 

00040 R 663325 A 


IDS V 

S0041 R 0@ii00 A 


0 

§@®4g R 040181 R 


DAC REMAIN# 

00043 R 841002 A 


LACQ 

28@44 R 040122 R 

/ 

OAC OUQTit 

00046 R 73S000 A 

ax 

®«§4@ R 2R0128 R 


LAC 8U0T 

i@@47 R @53383 A 

NEXXT 

IOIV 

®0f8§@ R 000012 A 


18 

00031 R as®112 R 


OAC DIGIT 9 X 

@®@St R @4100® A 


L AGO 

ii0S3 R 74|gf!0 A 


SNA 

®0@S4 R 0i®057 R 


JMP OUNN 

00055 R 737001 A 


AXR i 

5§W6 R 6S8047 R 

i 

JMP NEXXT 

30057 R 128125 E 

OUNN 

JMS* CRIP 

30060 R 210118 R 

/ 

OUNNN 

LAC DIGIT # X 

00061 R '340132 R 


TAD C860 

i0062 R 180128 E 


JHS# PRINT 

00063 R 73777? A 


AXR -®1 

00064 R ?24ii@ A 


PX A 

00066 R 74010® A 


SNA 

00063 R @@@@SP P 


JMP DUNNN 

0i06? R 200133 R 

f 

LAC (256 

00170 R 120126 1 

i 

JMSt PRINT 

00071 R 200117 R 

/ 

LAC COUNT 

01072 R 0401®® R 


OAC REM 

00073 R 800183 R 


LAC REMAIN 

80(974 R S53liS^ A 


MUL 

22075 R 000012 A 


18 

00076 R 641®0t A 


LAM 

00077 R 853383 A 


IOIV 

0010® R A 

RgM 

0 

00101 R 641008 A 


LAGS 

@8i@g R 340|3g R 


TAD cafl® 

§0103 R 120188 E 


JMS* PRINT 

00104 R 120128 E 


JMS# CRIP 

gilPS R 750004 A 


LAS 

ii|06 R 74i2ig A 


82A 

00107 R 004 R 

i 

JMF 1NIT 
• EXIT 

20118 R A 

DIBIT 

/ 

@ ILOCK B 

0ii@ii R 

f 

iEND BESIN 

0©!gS R SSilSS E 



00126 R 000126 1 



00127 R 0iiil5 A 

*L 


00130 R i®00S4 A 



@@131 R 000017 A 

#L 


®i|38 R i®i88i A 

*L 



00133 R iii8S@ A *L 


/6ET * OF VALUES 
/STORE FOR DIVISION 
/SET SUM 


/REMAINDER RETURNED IN AC 
/Bit SUOniNT IN MQ 


/STORE IN TABLE 

/PIC« UP QUOTIENT 

/CONTINUE IP NOT 0 

/STOP WHEN QUOTIENT ® i 

/PUT IN TABLE FOR LATER OUTPUT 


/ISSUE m AND LF 


/TO MAKE ASCII 

/GET NiMT CHARACTERwwWORK 

/WAV SACK UP TA18E 

/ARE WE D0Ng«»NH£N ViS 


/ISSUE DECIMAL POINT 58 . 88 




/WANT TO CONTINUE OR EXSTf 
/IP SWITCHES ARE @ e THIN EXIT 
/NON^IERO®^CONTINUE WITH ANOTHER 



PROGRAM INTERRUPT FACILITY (PI) 


References? Volume 1 Processor Handbook 5-11 
System Reference Manual 3»»8 


Preface? The Program Interrupt Facility increases the 

efficiency of input/output operations by freeing a 
program from the necessity of constantly monitoring 
device flags. When PI is enabled and a peripheral 
device becomes available or completes a transfer® the 
PI automatically interrupts the program sequence and 
causes a 9 MMS 000000** to occur, A subroutine at location 
000000 may then sense the device flags to determine which 
of the devices caused the interrupt,service the device, 
and return to the main program® 


The running time of programs using input and output routines 
is primarily made up of the time spent waiting for an I/O device 
to accept or transmit information., Specifically® this time is 
spent in loops such asi 

TSF /SKIP ON FLAG 

JMP «—1 

Waiting loops waste a large amount of computer time* In those 
cases where the computer can be doing something else while wait¬ 
ing® these loops may be removed and useful routines included to 
use the waiting time a This sharing of a computer between two tasks 
is often accomplished through the program interrupt facility® which 
is standard on all PDP-15 computers® The program interrupt facility 
allows certain external conditions to interrupt the computer program® 
It is used to speed the processing of I/O devices or to allow certain 
alarms to halt program execution and initiate another routine® 

Each of the input/output devices has associated with it a device 
flag which is set to 1 whenever the device has completed a transfer 
and is ready for another• When the Program Interrupt Facility is 
enabled® the setting of the device flag (connected to PI) causes a 
program interrupt request® When PI is disabled® program interrupts 
do not occur® although device flags may be set® 

When the interrupt is granted® PI is disabled automatically® 
the main instruction sequence is suspended and the hardware executes 
a **JMS Q0000Q 98 8 This causes the contents of the Program Counter (the 
address of the next instruction that was to be executed) to be stored 
in location 000000 and the instruction in location 000001 to be 
executed, 

The routine entered due to the interrupt is responsible for 
finding and servicing the device that caused the interrupt® Usually® 
the instruction in location 000001 is a JMP to a sequence of code 
called a SKIP CHAIN which determines which device®s flag caused the 
interrupt and then jumps into a service routine for that specific 
device® » 



PROGRAM INTERRUPT FACILITY 


The individual service routine then handles the condition 
causing the interrupt, reenables the Program Interrupt system and 
resumes mainline program execution by JMPing to the location 
pointed to by location 000000® 

The I0T instructions used to program the PDP-15 for 
program interrupts aret 


ION 

700042 

-Interrupt ON 
-Enable PI interrupts 

I OF 

700002 

-Interrupt OFF 
-Disable PI interrupts 

RES 

707742 

-Restore®••i.e s set up 


the restoration of the 
Link @ Page/BanK mode f 
Memory Protect bit from 
the pointer word given 
in the next indirectly 
referenced instruction® 


Use of the interrupt system allows a mainline routine, 
referred to as the BACKGROUND PROGRAM f to execute without 
wasting a large amount of time in waiting loops while I/O devices 
devices are assembling and transmitting information® The 
interrupt service routine f called a FOREGROUND PROGRAM^ is 
entered automatically whenever an I/O device requires 
servicing under program control® 





REQUESTING AN INTERRUPT 



requests for program interrupt 
are made when flags' are raised 
£ C2€a>.S f.lCSCi *tc^ *P 1 © 


no interrupt 
request 


GRANTING AN INTERRUPT 



— when the CPU receives a 
request for an interrupt, it 
must decide if that interrupt 
can be granted© 


no interrupt 
keep request 


PI interrupts 
only 

1) i£ PI is on 

2) between instructions 

3) after a non^priwileged 
instructions (privileged 
instructions t IOTs, JMS , 
CJUL^XCT^NORM) 


^NOTEi The following have priority 
over Pit 

1) Data Channel Transfers 

2) Clock breaks for updating 
location 00000? 

3) API hardware interrupts 


PI Interrupt Granted 1 



CPU. PROCESS OF m JWggmtPPT 


( Interrupts 
„ Granted J 

t 

Disable 
PI 


Hardware 

F®ree XCTl 
of 

JMS a 0 


— an interrupt -consists of i 

D&Lsabliag PI 
2)executing a JMS 000000 



Recall that information is also stored in bits 0 @ 1 @ 
on a JMS® Location 000000 


and 2 


Bit 0 ® Link at tine of interrupt 

1 ® Page/Bartc Matte.Indicator 

2 «...Memory Protect Indicator 


The word in location 000000 the following format* 


© 1 2 3 ... ..' . 1? 



Page 

Memory 

15 bit address ©f the instruction that was 


Bank 

Protect 

to be executed at time of interrupt 








PROGRAM INTERRUPT FACILITY 


Single Device Interrupt Programming 

When programming a system with only one possible source of 
interrupts, say the paper tape reader 9 the handling of an inter 
rupt is very straight forward and simple a 


0 000000 

1 JMP PTREAD 


PTREAD DAC ACSAYE /save registers used by the servie routine 

© 

© 

1 code to handle the reader 

t -was it the completion of a read or an 

2 error condition that caused the interrupt- 

l -store away the character read from the tape 

l -cheek to see if there is more to read 

l if so®«•initiate the next read 


EXIT LAC ACSAVE 
■ ION 
RES 


JMP* 000000 


/reenable PI 

/set up to restore the Link® 

/mode @ Memory Protect bit on the next 
/indirectly referenced instruction from 
/bits 0*1 and 2 of the pointer word 

/go back to where we left off 


Multiple Device Interrupt Programming 

Many programming applications use the interrupt system to 
service several devices® For example® a PDP-15 may use the 
interrupt facility to control the operation of paper tape (reader 
and punch) through a teletype® Systems of this type require a 
service routine that determines the source of an interrupt request 
(i®e® which device flag is set)® The following instruction sequence 
uses dummy I0T Skip instructions to determine which device requested 
an interrupti 

D1SF /is it Device I? 

8KP /no 

JMP D1SRV /yes—go to Device 1 service routine 

D2SF /is it Device 2? 

SIP /no 

JMP D2SRV /yes—go t© Device 2 service routine 
© 

© 

DnSF /is it Device n? 

JMP ERR /no—not device 1-n, go to error routine 

JMP DnSRV /yes—go to Device n service routine 




PROGRAM INTERRUPT FACILITY 


For example , suppose we have a PDP-15 system with high speed 
paper tape reader and punchy teletype and clock and that is all* 
The following gives a skip chain that could be used a 


0 000000 

1 JMP SKPCHN 



R8F 

SKP 

JMP KYBD 

TSF 

SKP 

JMP TPRINT 


/did the keyboard cause it? 

/no 

/yes—go to keyboard service routine 

/did the teleprinter? 

/no 

/yes—go to the teleprinter service routine 



PSF /did the paper tape punch? 

JMP ERROR /no—illegal interrupt occured-go to error routine 

JMP PUNCH /yes——go to paper tape punch service routine 


CLOCK 


DAC ACSAVE 


LAC ACSAVE 

ION 

RES 

JMP* 000000 


DAC ACSAVE 


JMP* 000000 

/ 

TPRINT DAC ACSAVE 


/ JMP* 000000 

PTREAB DAC ACSAVE 


/ 

PUNCH 


JMP* 000000 
DAC ACSAVE 


JMP* 000000 


PROGRAM INTERRUPT FACILITY 


An interrupt grant will cause the computer to perform the 
following operations automatically! 

1. The PI system is disabled* - . 

2 . The contents of the PC is stored at memory location 000000. 

3. The ”JMP SKPCHN” in location 000001 is executed, 

(note that steps 2 and 3 are the equivalent of executing W JMS 000000”) 

The SKPCHN routine then determines the source of the interrupt 
and passes control to the appropriate device handler @ 

The device handler (interrupt service routine) then performs 
the following operationsi 

1, The contents of the Accumulator (and any other registers 
which will be used) is saved 

2 0 The interrupt is processed — 

-determine whether flag was raised due to completion 
of transfer or an error condition 

. -store data transferred, in and clear flag. 

input -determine if more is to be input (if so § initiate it) 

-determine if more data is to be output (if so @ initiate it) 

output _ clear flag 

3 0 Restore the Accumulator(and any other registers used 
and therefore saved)@ 

4® Turn the interrupt system back on (if further interrupts 
are to be allowed) # 

5 @ Set up for the restoration of the LinJc^ Page/Bank mode.* 

Memory Protect mode. The "RES 98 instruction primes the system 
for this restoration^ although it does not actually occur 
until the next indirectly referenced instruction is executed 
(and then it is done using the contents of bits 0^1 and 2 
of the pointer word) e 

6, Return to the mainline program via a MMP* 000000” 
instruction (recall that the updated PC was stored in 
location 000000). 



PROGRAM INTERRUPT FACILITY 


NOTES 


1® Instructions like CLSF 9 KSF and PSF are skip-on-flag 
instructions. There are Skip IOTs for every device in the 
interrupt system. Because of the predominance of skip 
instructions in the instruction sequence which determines 
the source of an interrupt request^ it is often called a 
SKIP CHAIN e 

A skip chain may be enlarged to test for almost any 
number of device flags, provided that high-speed devices which 
retain information for a relatively short period of time are 
tested near the top of the skip chain f so that the chain may be 
traversed and the high-speed devices serviced .before the infor¬ 
mation is lost. High-speed devices should never be required to 
wait for service while a long skip chain is traversed. 

Notice that the order in which the Skip IOTs are placed 
in the skip chain actually determines the priority of a device, 

If two devices have their flags raised simultaneously f the device 
whose Skip IOT appears closest to the top of the skip chain will 
be serviced first. 


2® It is possible that the SKIP CHAIN will not be in page 0 
or bank 0 9 in which case a ,C JMP SKPCHN” instruction in location : 
won®t allow you to get there. Insteadi 


will allow you to get 
up from location 2 e 


0 


to SKPCHN because a 


SKPCHN 


iSS IS 


3, Similarly, it may be that the individual device service 
routines will not be located in the same page or bank as the 
SKIP CHAIN § and therefore will have to be entered indireetlyi 


SKPCHN 


VKB 

VTP 


KSF 

SKP 

JMP* VKB 

TSF 

SKP 

JMP& VTP 
JMP ERROR 

KYBD 

TPRINT 


4@ With some devices, error condition flags set to 1 will also 
generate interrupts. It is therefore the service routiners 
responsibility to determine if the interrupt was caused by the 
completion of a transfer or by the existence of an error condition. 

For example ^ an interrupt may be caused by the paper tape reader 

-when i v e 

. a) it has read a character and has assembled it in its buffer 

b) it has attempted to read the tape but finds a no tape 
condition® 

Some error conditions may be checked using the IORS instruction. 

In other cases, devices have their own status registers indicatinc? 
errors (e.g, MT, DK 9 DP,DT). a 



AUTOMATIC PRIORITY INTERRUPT (API) 


References: Volume 1 Processor Handbook 6-46 

System Reference Manual 3-10 


Overview: The Automatic Priority Interrupt system option in¬ 

creases the capability of the PDP-15 to handle trans¬ 
fers of information to and from input-output devices. 

API identifies an interrupt device directly, without 
the need of a SKIP CHAIN routine for flag checking. 
Multi-level interrupts are permissable where a device 
of higher priority supersedes an interrupt already in 
progress. These functions increase the speed of the 
input-output system and simplify the programming. In 
this way devices (especially high speed devices) can 
be serviced efficiently. 

The API option increases the I/O handling capabilities of the 
PDP-15 by adding eight levels of priority servicing (0 - 7) and 
associating 32 channels with these eight levels. The highest 
four levels of priority, i.e. 0, 1, 2, 3 are assigned to hardware 
devices. The lower four levels, i.e. 4, 5, 6, 7 are for software 
purposes. 

Of the 32 API channels, 4 are assigned to the software levels 4-7 
The remaining 28 channels are available for use by the hardware 
levels 0-3. Each of the four hardware levels may have eight 
devices (channels) tied to it, up to the total of 28 for the 
four levels. This is strictly a hardware limitation imposed 
by cable lengths and circuit delays, and attempts to circumvent 
this restriction will create needless problems. 

Each of the 32 channels is assigned to a specific memory loca¬ 
tion called the Break Address. The break addresses are locations 
40 - 77 in page 0, bank 0. Each device tied to API is associated 
with a specific channel (and therefore break address) and a specific 
priority level. The table below gives the standard assignments. 

The channel assignments should remain fixed for software compat¬ 
ibility, but the suggested priority level may be changed (re¬ 
wiring needed) at the discretion of the user. 



API ADDRESS 


API 

Channel 

Break 

Address 

Standard Device 

Suggested 

Priority 

Level 

0 

40 

Software channel 0 

4 

1 

41 

Software channel 1 

5 

2 

42 

Software channel 2 

6 

3 

43 

Software channel 3 

7 

4 

44 

DECtape (TC15) 

1 

5 

45 

MagTape (TC59) 

1 

6 

46 



7 

47 



10 

50 

Paper Tape Reader (PC15) 

2 

11 

51 

Clock Overflow (KW15) 

3 

12 

52 

Power Fail (KF15) 

0 

13 

53 


0 

14 

54 

Graphics (VT15/VP15) 

2 

15 

55 

Card Readers (CR15/CR03B) 

2 

16 

56 

Line Printer (LP15) 

3 

17 

57 

A/D (AD15/AF01) 

0 

20 

60 

DB99A/DB98A 

3 

21 

61 



22 

62 

Data Phone (DP09A) 

2 

23 

63 

DECdisk (RF15) 

1 

24 

64 

Diskpack (RP15) 

1 

25 

65 

Plotter (XY15) 

1 

26 

66 



27 

67 



30 

70 

Scanners (DC01-ED) as needed 3 



use 70-77 


31 

71 

UDC15 


32 

72 

ADC 15 


33 

73 



34 

74 

LT19 S LT15 Teleprinter 

3 

35 

75 

LT19 & LT15 Keyboard 

3 

36 

76 



37 

77 





Each device , when granted service via the.API facility,.sends its 
specific break address to the computer. This address, which will 
normally contain a JMS instruction to the device service routine, 
will then be executed by the computer. This type of interrupt 
service eliminates the need for time consuming flag search routines, 
and extensive core use for interrupt handling routines, by^automat¬ 
ically determining which device requested service and providing 
immediate entry to the proper service routine. 

Higher priority devices will be able to interrupt lower priority 
routines upon sending and having a request granted. The priority 
of devices multiplexed on the same priority level is determined by 
the relative position of the devices on the I/O bus. The first 
device on the bus having highest priority at that level, the 
second having second highest priority, etc. 

The entire API facility can be enabled or disabled by a single 
IOT instruction. There is no way to enable or disable.specific 
priority levels. However, for §©me devices there are instructions 
to disconnect itself from the API facility. 

In addition to the above, there are two special features in the 
API facility. These are: 

a. The CAL Instruction - Execution of a CAL instruction with the 
API facility enabled automatically sets priority level 4 
thereby shutting out software requests of a lower priority 
until this level is released. 

b. Program Interrupt - A program interrupt, from any I/O.device 
connected to the computer, sets priority level 3. This occurs 
whether or not the API facility is enabled. This causes 

all devices on priority level 3, all software requests and 
program interrupts to be shut out until the level Is released. 

Special care must be taken in the programming of the API option 
to take account of these two features. 




REQUESTING AN API INTERRUPT 



requests for API interrupts are 
made when device flags 3 which are 
tied to the API system 3 are raised. 




GRANTING AN INTERRUPT 


If PI is on, 
request will be 
processed for PI 



when*the CPU receives a request for an ir 
interrupt 3 the CPU must decide if that 
interrupt can be granted under API. 


®NQ.TE 


The CPU decides if it can 
grant an API interrupt in 
response to the API request - 
The following have priority w 
over API: 

1) Data Channel Transfers 

2 ) Clock breaks for updating 
location 0 00 0 07,. 


API interrupt request granted 



PROCESSING AN API INTERRUPT -in processing an API 



.interrupt, the CPU 
< 1) sets a priority level 
bit to inhibit interrupts f 
from channels .of the same 
or lower level of priority 

.2) picks up the break 
address sent by the device 

3) does a hardware forced 
XCT of the contents of the 
break address 


The IOT instructions used to program the API system are: 

DBK 703304 -Debreak 

-Reset the highest priority level bit so that 
operations may be carried out on same or lower level. 

RES 707742 -Restore 

-Set up to restore the link 9 page/bank mode and memory 
protect mode on next indirect instruction. 

DBR 703344 -Debreak and Restore 

-Initiate Selected Activity 

-Used to initiate software level interrupts and to 
raise the priority level of an operating program. 



ISA 705504 






SINGLE DEVICE INTERRUPT PROGRAMMING 


When programming a system with only one possible source of in- 
terrupts, say the paper tape reader, the handling of an interrupt 
is straight forward and simple. 



JMS PTREAD 


M2 Stored here after JMS PTREAD 
DAC ACSAVE 



When an API interrupt Is granted to the Paper Tape Reader, it t 
sends to the CPU its break address (50). The contents of location 
50 Is n XCT T? ed. Since an XCT instruction does not change the PC 9 
the PC that gets stored in location PTREAD is the updated PC from 
the mainline program (location M2). The interrupt is processed 
by PTREAD and it does a debreak to release level 2 (its priority 
level) and then JMPs back to the mainline program using location 
PTREAD as a pointer. 


00 



MULTIPLE DEVICE PROGRAMMING 


When there is more than one device attached to API 3 handling 
an interrupt simply requires setting up the associated break 
address with a JMS to the interrupt service routine. 


50 

JMS 

PTREAD 

51 

JMS 

CLOCK 

52 

JMS 

PWRFL 


PTREAD 

0 



DAC 

ACSAVI 


LAC 

ACSAVI 


DBR 

JMP* 

PTREAD 

CLOCK 

0 



DAC 

ACSAV2 


LAC 

ACSAV2 


DBR 

JMP* 

CLOCK 

PWRFL 

0 



DAC 

ACSAV3 


LAC ACSAV3 

DBR 

JMP * PWRFL 


With this system there is no need for polling because when a 
device is granted an interrupt, it sends to the CPU its associated 
break address, which can then contain a JMS to a routine to 
handle that device. 

While in the service routine for one device, a higher priority 
interrupt may be granted. This presents no problem because of 
the manner in which return addresses are stored. 



Break Addresses 



LV2B INSTR 



MLV2B 


0 


JMP* LEWRT 


In this example, a level 2 device has break address N while a 
level 1 device has break address M. The routine to.service the 
level 2 interrupt is LEV2RT and the routine to service the level 1 
interrupt is LEV1RT. 

When the mainline routine is interrupted by the level 2 device 
between instructions in Bl and B2, the PC Is pointing to :B2. The 
level 2 device sends its break address of N to the CPU so that the 
JMS LEV2RT instruction may be "XCT"ed. This causes the address 
B2 ("the contents of the PC) to be stored in location LEV2RT and 
control passed to location LEV2RT + 1. If while we are at priority 
2 in routine LEV2RT an interrupt is r equested by a de vice at level 1 
that Interrupt can be granted because of its higher priority,. 

Suppose it is granted between instructions atLV2A and LV2B. „ Then 
the PC contains the address LV2B. The level 1 device sends Its 
break address of M to the CPU so that the JMS LEV1RT instruction 
may be executed. This causes the address LV2.B to be stored at 
location LEV1RT and control passed to location LEV1RT + 1. The 
level 1 routine processes the level 1 interrupt. When it executes 
the JMP* LEV1RT instruction control is passed back to the level 2 
routine at the point we left off, LV2B. The LEV2RT routine may now 
resume its operation. When the JMP* LEV2RT instruction is executed, 
we go back to the mainline routine at location M2 where we left 
off and continue from there. 





A 



iS^Sb 





A b IP-...AODRESS IS -A-MUHMH* ( 4 ^ 0 T--A--^ 4 MM»CM S 4 -- TMfc-AWMSS - J 3 -A.SS 0 l.UTE. 

3® -XP- THE A-PD-RES-S- IS A 8¥ H-B-Qi .It. A riXifC T. 

assignment statement (I.E. ®5 and THE RIGHT-HAND SIDE OF THE 

...kmtmmm is juwjaap f all -mmmMCLs. s.u~-XH.^$y.mau .w ill- be 

ABSOLUTE b 


IF 

the 


A USER LA8EL OCCURS WITHIN A SLOCK OF CODING THAT IS ABSOLUTE. 
Mill IS AWOUJ-TI-, - - ______ __ _ 


-¥-A*£ABL«* - am gEjl^J^XLTM-gOL y - EX T - ER M A V-T^AN S F E R -V. ECXOfly-~AND 
LITERALS GET THE 8 Am RELOCATION AS WAS IN EFFECT WHEN a END 
encountered -in bass .%.. w . ____...._. 


WAS 


.XfL-tHE L0CA TI0N-COUNTER ytOC -B4^UQCtXIRT-R-£F.ER£NCES--A 3Y-MBGL 

WHI6H IS NOT DEFINED IN TERNS OP AN ABSOLUTE ADDRESS, ?Hg SYMBOL 
.. -X3- RELOCATABLE-,____________ : .... 

P® ■ -ALL 0-T--HERS ARg-.-J5LgL.OC AT ABLE._______ ___ __- 



'0^'j 



JH&9*vn 



-PACE .-4--- RULES . E*A- 


LXN KING-. LOADER 


.— ■- ....—rfllflgL EUB- 

0 R 0 R 05 A A»S 

- ..—.- W«M JSL._. 8 mg X.4JLI_ 

ifitfti® R A START LAC A 

mtaat-R .swaii-i___ lmlxji_ 

t 0 i ®8 R 2 ® 0 ® 0 ® R LAC B 

BERRg.:..R .Rig®®® R_ __-LAC START_ 

M ®@4 R 2 ? 0 ® 1 ® f LAC^ SUB 

®®14S- .r — ..lac. am _— 

R 2®rn IB A LAC (START 


R sloe START + S 

8044-5- R 2 MM ®4 B - A - ET-ART1 -LAC -4#__ 

i«®@0 R P LAC START! 

n . . siMX _'_ 


-§144t- ..A _______^LO C R _ 

0®i@0 A 200®0g R L a C START 

0®«»i k mmm n ..... --lac starti 

@®B*3 A 2*0910? A STARTS? LAC STARTf 
a@8®3 A @«0100 R. ..START_ 


-- 00000 ® a.. 

00010 A 000010 6 #e 

000.14 A 000.100 A *L 

®0@ig A 00000® R #L 

.-. SIZEI00013. 


.JEJNOL 


NO ERROR.LINES. 

103 
















SOS -I 5 V3A000 
$A LP »12 

SK ON 

SPAGE ON 


$LOAB 

LOADER V5A000 
>P4»RELOC 

P HELOC SRC 77614 
t S tQ 

DOS-15 W3A800 
$BUMP 

DUMP V3A000 
>77614-77637 

DUMP V3A000 
>tC 


BOS-I5 V3A0M 
$BANK ON 


8L0ABER V3A000 
>P*-RELOC 

P RELQC SRC 77614 
* tS f Q 


DOS-15 V3A000 
S1UMP 

BUMP V3A000 
>77614-77637 


DOS -I 5 V3A000 



P AGE 1 


REIOC SRC 


PROGRAM SHOWING RELOCATION ELEMENTS 

aTITLE PROGRAM SHOWING RELOCATION ELEMENTS 



t! 




000 9l 0 R 2 ® ® ® I 3 R 
SP9C81 R 200017 R 
$0 i/102 R 0^0^14 R 

mm 3 r 04iii7 p 

fl®®&4 R 220013 R 

aeiRRS R 160011 a 

3RBP6 R SS001® A 

R0007 R 200010 A 

00010 R 200021 R 

00011 R 200028 P 

00012 R 040020 ft 

00013 R 00,1000 A SYMBOL 

00014 R 0®0@fl® A 

00019 R 000004 A 

00016 ft 0i00P»9 A END 

A 

00021 R 00001© R *L 
00022 R 000003 A *L 

SIZEP6SR23 


LAC SYMBOL 
LAC B# 

OAC SYMBOL^1 
0AC B 

LACt SYMBOL 
DZM* 11 


LAC 

LAC (END 

LAC (ENOwSYMBOL 

DAC C 

mm 


1 ERROR LINES 



77©|0 0®0®0© 000000 

77620 227627 166611 

J7630 000000 000004 


0000S0 606G0G 2@76t7 

820010 800010 207838 

WW 006000 600866 


107833 @47630 047633 

007636 ®47634 005000 

i?7S3g 000003 000762 


\ 


BANK LOAD 


77614®77§37 

y?6f$ @00000 0®@P@0 

77©?® 237627 160011 

77530 55&W00 0P0004 


080000 00i®0@ 2I7S37 

28001® 2®0®i® 817638 

088003 ®00@i® 00®@0® 


817033 @5703® 057033 

i 17636 057634 mmm 

877S32 080003 00076? 







^OS-15 V3A000 

n? 

POSPiP V3A000 

>1 XT COP1A BIN «- DTI 


06-MAR-75 
DIRECTORY LISTING 
346 FREE BLKS 
66 USER FILES 
I 10 SYSTEM BLKS 
COPIA BIN 455 1 


»L IT COPIA BIN «- BK CP) 

- ' l """" 1 " 111 , " n " 11 

06-MAR-75 

"■> DIRECTORY LISTING CPES) 

2202 FREE BLKS 
32 USER FILES 
34 USER BLKS 

COPIA BIN S5S7C2) ' 1 06-MAR-75 1567 100 


T C 

dOS-15 V3A000 
$A DTI -14 


SA TT -12 

SDUMP 

J3UMP V3A000 
^55# 








455# 

0 

015000 

646531 

262601 

000004 

000005 

000070 

071033 

412450 

000001 

1 0 

034150 

074623 

230204 

400000 

000000 

000004 

040404 

20 

000000 

000000 

040404 

001005 

000001 

000000 

040404 

000000 

30 

002004 

000010 

015000 

317540 

050404 

000025 

777736 

000004 

40 

040404 

000012 

002005 

00001 1 

050404 

000025 

777736 

000005 

50 

040302 

000012 

600010 

000067 

040710 

000000 

407716 

022600 

60 

230710 

000025 

420564 

052033 

005000 

520247 

230710 

000067 

70 

100 

474741 

TO 

071640 

367 

232700 000010 000010 

CONTAINS 000000 

000011 

001005 

776773 

m tfW tag **9 

370 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

777777 



PAGE 1 


C0P1A 


lOiEV 4«5 


/ 

/ 



00000 

n 

000004 

A 

3^6 

/ 

• INIT 4@0 f 0 
C'AL+0*1000 4&T77 


00001 

R 

00000I 

A 

Q 


1 


00002 

R 

000000 

A 

$6 


04-0 


00003 

R 

000000 

A 



0 







/ 

• INIT 5.1J 


00004 

n 

001005 

A 



CAL+1*1000 5&T77 


00005 

n 

000001 

A 



1 


00@@6 

n 

000000 

A 



0+0 


00007 

n 

000000 

A 



0 


00010 

R 




/ 

START 

•REAB 4 a 2 l*BJJEE •iA- 


00010 

n 

002004 

A 



CAL+2^1000 4<&777 


0001 1 

n 

000010 

A 



10 


00012 

R 

000025 

R 



BUFF 








®BEC 

00 

00013 

R 

777736 

A 


/ 

"34 







♦WAIT 4 

,#fe 

0001 4 

Pv 

000004 

A 

*6 


CAL 4&7T7 


00015 

R 

@00012 

A 


/ 

12 

fglfe 






♦ WRITE 5 a 2 «BUFF a 34 


00016 

R 

002005 

A 



CAL+2*1000 5&777 


00017 

R 

000011 

A 

* G 


11 

^SRk 

0@@2i 

R 

000025 

R 



BUFF 








• IEC 


00021 

R 

777736 

A 



“34 

idfe 

00022 

R 

000005 

A 

=f* G 

/■ 

♦ WAIT 5 

CAL 5A777 


00023 

R 

000012 

A 


/ 

12 


00024 

R 

600010 

R 


JMP START 

A 






/ 



00025 

R 


A 


BUFF 

♦BLOCK 42 







/ 


00 

00067 

R 

000000 

A 


EN1MRK 

0 







7--- 








/ 


48^ 



000010 

R 



®ENI START 




SIZE 

=00070 

NO ERROR LINES 




tc 

MS-15 V3A080 
SA BK -14 


SDUMP 

DUMP V3A800 
>1567# 

1567# 


0 

815500 

646031 

10 

034150 

074623 

20 

000000 

080000 

30 

002004 

00001 0 

40 

040484 

000012 

50 

040302 

000012 

60 

230710 

080025 

7® 

474741 

871640 

100 

80000I 

801567 

110 

TO 

367 

370 

000000 

880000 


262601 

000004 

000005 

230204 

480000 

000008 

840404 

801005 

080081 

015500 

317048 

050404 

002805 

00001 1 

050404 

60001® 

000067 

040710 

420564 

052033 

805500 

232700 

00001® 

000018 

000000 

00080® 

000000 


CONTAINS 000000 
000800 080000 000000 


000070 

071233 

412450 

080004 

040404 

000001 

088000 

040404 

.000000 

080025 

777736 

000004 

800825 

777736 

00080-5 

000000 

407716 

022680 

517547 

238710 

00006,7 

000011 

001205 

776773 

800000 

008880 

008000 

880000 

777777 

777777 


108 



RADIX 50g VALUES 


X— 


-X- 


““X 

i A 

003100 

A 

000050 

A 

000001 

B 

006200 

B 

000120 

B 

000002 

C 

011300 

C 

000170 

C 

000003 

D 

014400 

D 

000240 

D 

000004 

E 

017500 

E 

000310 

■I 

000005 

F 

022600 

F 

000360 

WBm 

000006 

G 

025700 

G 

000430 


000007 

H 

031000 

H 

000500 

Kfl" 

000010 

I 

034100 

I 

000550 

I 

000011 

J 

037200 

J 

000620 

■■ 

000012 

K 

042300 

K 

000670 

1H/ 

000013 

L 

045400 

L 

000740 

L 

000014 

M 

050500 

M 

001010 

M 

000015 

N 

053600 

N 

001060 

N 

000016 

0 

056700 

0 

001130 

0 

000017 

P 

062000 

P 

001200 

P 

000020 

Q 

065100 

Q 

001250 

Q 

000021 

R 

070200 

R 

001320 

R 

000022 

S 

073300 

S 

001370 

S 

000023 

T 

076400 

T 

001440 

T 

000024 

U 

101500 

U 

001510 

U 

000025 

V 

104600 

V 

001560 

V 

000026 ! 

w 

107700 


001630 

W 

000027 

X 

113000 

mm 

001700 

X 

000030 

Y 

116100 

■9 

001750 

Y 

000031 

Z 

121200 

z 

002020 

Z 

000032 

% 

124300 

a 

*o 

002070 

% 

000033 

« 

127400 

<9 

002140 

© 

000034 

0 

132500 

0 

002210 

0 

000035 

j 1 

135600 

1 

002260 

1 

000036 

2 

140700 

2 

002330 

2 

000037 

3 

144000 

3 

002400 

3 


4 

147100 

4 

002450 

4 


5 

152200 

5 

002520 

5 


6 

155300 

6 

002570 

6 

000043 

7 

160400 

7 

002640 

7 

000044 

8 

163500 

8 

002710 

8 

000045 

9 

166600 

9 

002760 

9 

000046 

# 

171700 

# 

003030 

# 

000047 
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F0RTRAN-1V AND MACRO 


In previous chapters, MACRO calling sequences have been given for OTS and Selene© Library Sub~ 
programs* This general form is used in a MACRO program to call any FORTRAN external subroutine 
or function* A FORTRAN program may also Invoke MACRO subprograms* The method for each typ© 
of linkage is given below* • 


«|> INVOKING MACRO SUBPROGRAMS FROM FORTRAN 

A FORTRAN program may invoke any MACRO program whose name is declared in a MACRO .GLOBl 
statement* The MACRO subprogram must also include the same number of open registers as there are 
arguments. These will serve as transfer vectors for arguments supplied in the FORTRAN CALL statement 
or function reference. A FORTRAN“IV program and the MACRO subprogram it invokes are shown 
below. 


FORTRAN 

MACRO 




.TITLE MIN 



C 

TEST MACRO SUER 


.GLOBLMIN 

, .DA 




MIN 

0 

/ 

entry/exit 

c 

READ A NUMBER(A) 


JMS* .DA 

/ 

general get 





/ 

argument 

I 

READ(1,100) A 



/ 

(OTS) 




JMP .+2+1 

/ 

fump around 

100 

FORMATS 12.4) 




argument 






registers 

c 

NEGATE THE NUMBER 





c 

AND PUT IT IN B 

MINI 

. DSA 0 

/ 

ARG1 



MIN2 

.DSA 0 

/ 

ARG2 


CALL MIN(A,B) 


LAC* MINI 

/ 

first word of A 




DAC* MIN2 

/ 

store at B 

c 

WRITE OUT NUMBER(B) 


IS2 MINI 

/ 

point to second word 




ISZ MIN2 

/ 

of A and B 


WRIT E (2,100) B 


LAC* MINI 

/ 

second word of A 




RAL 

/ 

sign bit = 1 




CML 

/ 





RAR 

/ 



STOP 


DAC* MIN2 

/ 

store in second 






word of B 


END 


JMP* MIN 


exit 




.END 







The FORTRAN statement CALL MIN(A,B) is expanded by the compiler to: 

00013 JMS* MIN / to MACRO subprog 

00014 JMP $00014 
00015 .DSA A 
00016 .DSA B 
$00014 = 00017 

When the FORTRAM-IV program is loaded, the addresses (plus relocation factor) of A and B are stored 
in registers 15 and 16, respectively. When the MACRO program invokes .DA, these addresses are 
stored in MINI and MIN2 and the values themselves are accessed by indirect reference. 

Arguments are, as described above, transmitted by .DA using a single word. Bits 3—17 contain the 
15-bit address of the first word. Bits 0-2 serve as flag. FORTRAN uses bit 0 to indicate that the word 
specifying the argument contains the address of a word containing the address of the first word of the 
argument. The MACRO argument word always contains the address of the first word of the argument. 

For array name arguments (unsubscripted), the address of the fifth word of the array descriptor 
block is given with bit 0 on . 

For external functions, the MACRO subprogram must return with a value in the AC (LOGICAL, 
INTEGER), AC-MQ (DOUBLE INTEGER) or in the floating accumulator (REAL or DOUBLE PRECISION). 


w+ INVOKING FORTRAN SUBPROGRAMS FROM MACRO 

The MACRO calling conventions for FORTRAN subprograms are: the name of the subprogram must be 
declared as global; there must be a jump around the argument address; and the number and mode of 
arguments in the ca!l must agree with those of the subprogram. This form is shown below. 


.TITLE MACPRG 
. GLOBL SUBR 
JMS* SUBR 
JMP .+N+1 
. DSA ARG1 

. DSA ARG2 


.DSA ARGN 


/ jump around arguments ignored by .DA 
/ address of first argument - bit 0 set to 1 
/ indicates indirect reference 


When the subprogram is compiled, a cal! is generated to .DA which performs the transmission of 
arguments from MACRO. The beginning of a subroutine might be expanded as follows. 


c 


000000 

000001 

000002 

000003 

000004 

$ 000002 = 000005 


TITLE SUBR 

SUBROUTINE SJBR(A,B) 

CALO 

JMS* .DA 

JMP $000002 

.DSA A 

. DSA B 


If a value is to be returned by the subroutine, it is most convenient to have this be one of the calling 
argumentso An external function is called in the same manner as a subroutine but returns a value in 
the AC (single integers), AC-MQ (double integers), or floating accumulator (real and double-precision). 
To store the AC, the MACRO program uses a DAC instruction. Values from the floating accumulator 
may be stored via the OT5 routines .AH (real) and .AP (double-precision). For FPP systems,- values 
are returned in a hardware accumulator and stored with an FST instruction. 


fflmif> COMMON BLOCKS 

FORTRAN COMMON blocks (and block-data subprograms) may be linked to MACRO programs. When 
the MACRO program is loaded, global symbols are first sought in the user and system libraries. Any 
remaining are matched, where possible, to COMMON block names. This cannot be done if 
programs are loaded via CHAIN and EXECUTE. For example: 


FORTRAN 

MACRO 

INTEGER A,B,C 
COMMON/NAME/C 
COMMON A,B 

.GIOBL NAME, .XX / .XX is name given to blank COMMON 
/by the FORTRAN Compiler 

DZM* .XX / CLEAR A - NOTE INDIRECT REFERENCE 

ISZ °XX /BUMP COUNTER 

DZM* .XX / CLEAR B 

DZM* NAME / CLEAR C 


Note that if the values are REAL (two words) or DOUBLE PRECISION (three words), the MACRO program 
must account for the number of words when accessing specific variables. 

DOS-15 and RSX-PLUS MACRO programs may also use the »CBD pseudo-op. For instance 
BASE1 XBD NAME 1 

will provide the base address of the common block NAME in the word that ss created and labeled BASE!, 
the size ©f the common block is 1 . For blank common, use for example: 


BASE2 XBD 


.XX 2 






PAGE 1 MACCAL SRC MACRO ROUTINE CALLING FORTRAN PROGRAM 

.TITLE MACRO ROUTINE CALLING FORTRAN PROGRAM 

adipOiu fort 

/099 ©f ©f i 00000009O0W0 

/ pmmkn requests uses to input the n of elements to 

/ IE SUMNKS IN ARRAY A Cl T0 |i CIEMINT8 MAY SB SUMMED)• 
/ THE USSR INPUTS A YALUg THAT IS ONI LESS THAN THE 

/ actual mmm oeameD. the input range s§ 

/ MA66AL CALLS FORT TO AOP i TO TNI NUMBER TYPED @ 

/ PORT IN TURN CALLS MACEK TO 00 THE SUMMING a 




808000 A 

IN«8 




iiSiii A 

OUT® 1 
/ 


^ ®®KP0 

R 


START 

.INIT ®e,IN.R8T 
.INIT »3,OUT,RST 

"N, 



/ 


0@@ii 

R 


RST 

.WRITE »3 ■ 2,MESS,34 



J 

.WAIT -3 

®80t§ 

R 


f 

CHECK 

.READ »?#3,@UPF,3 
.WAIT >2 


/READS I CHARACTER 


88824 

R 

880146 

R 

/ 

CK| 

LAC 

BUFM8 

®0®2§ 

R 

340IS1 

R 


TAD 

C^ii 

0»aa@ 

R 

@4@I4@ 

R 


OAC 

SUPF^g 

80027 

R 

741180 

A 

CK2 

SPA 


80030 

R 

8@ii4@ 

R 


JHP 

gRRMES 

08831 

R 

34il6i 

R 


TAB 

C® 12 

80032 

R 

748180 

A 

«5 

SNA 


8ii33 

R 


R 


JMP 

ERRMES 

88034 

R 

g@i!4@ 

R 

CK4 

LAC 

iUFF^a 

$8®3§ 

R 

04S85S 

A 

Ft 

i 

QAC 

COUNT 

0003© 

R 

I20IS@ 

E 

& 

JMS^ 

. PORT 

®i®37 

R 

6@®@41 

R 


JMP 

@ ^2 


R 

000000 

R 


@ DSA COUNT 


/X»60# OR 

/MS® SO ENTRY NOT 0»9 
MEANS t®72 
/X<78 MEANS ENTRY 
/X>OR*70 MEANS NOT M 


@0@41 R 780®04 A 
®@04g R ?4®2®0 A 
80043 R 0080 10 R 





iii46 R 

00034 R 6@iS8f6 R 


/ 

gRRMES e WRITE *3#8 e Mi8KR^|S4 
.WAIT 
JMP CHECH 

/ 


000SS R 000000 A COUNT i 




E g MAecAU SRC MACRO ROUTINE CAUUN8 FORTRAN RRQSRAM 


00058 R 01100® A 
00057 R @@@0@P A 
00060 R 828632 A 
00061 R @4@80@ A 
00088 R 446544 A 
®@@SS R @47634 A 
00064 R 493011 A 
@MM R 448646 A 
08066 R 91B01S A 
00887 R 44488® A 
@007® R 471018 A 
00871 R 444818 A 
00078 R 202382 A 
00073 H 846004 A 
08074 R 486444 A 
00078 R 947814 A 
0007® R 808151 A 
@0@77 R 448832 A 
00100 R 426388 A 
00101 R 4S1S00 A 
00102 R 34037? A 
00103 R 528253 A 
@0104 R 476S31 A 
001@S R 4481@@ A 
00106 R 468031 A 
00107 R 342880 A 
00110 R 516831 A 
06111 R S4@8jg A 
80112 R <381000 A 
00113 R @30132 A 
@0114 R 348826 A 
00115 R 008908 A 
90118 R @84000 A 
00117 R 000000 A 

00120 R 012000 A 
00181 R 0igi®i A 
00122 R S3gil! A 
00123 R 4itS|g A 
00124 R t@giS8 A 
00125 R 32023® A 
00188 8 §fi6Sfi4 A 
0@|g7 R ®4?«|4 A 
00130 R tig4i0 A 
00131 R 147816 A 
@i 133 8 48S344 A 
80133 R 000000 A 

00134 r iggaag A 

00135 R i4iS®0 A 
0013® R t3S4®8 A 
00137 R S14§!@ A 


/ 

MIS I MlSERR«»Hfill/a^liil 

• ASCII /TYRE IN ONI LESS THAN THE NUMilfit OF EtU'H 


/YOU 



•ASCII <18* 

MESERR BUFF»MBS*RR/2*1000 

i 

b ASC11 /VAUUI II OUT OF RAN6E • / 


ASCII /TVRE 1S-9 1 ONt¥/^li^ 



9k&t 3 MACCAL SRC MACRO RQUTINt CALLING FORTRAN Mm" 


001*1 R 648268 A 

001*0 r mmm a 

«®|43 R 000009 A 

@@144 r aase®© A 
@@148 R ®0®00® A 
08146 R A 


/ 

SUFF KN0L0C®»8UFP/8^l@iff 
i 

s SL0CK f 


iiiiSi i ENDLQCi@ 

§mm$ R @ SN0 STAflT 

00180 R i@@iS0 E 
00191 R 7???2© A ^?L 
00198 R 777760 A 




«01 

6 

FORTRAN CAULXN6 MACRO EXAMPLE 

m2 

f* 

L* 




md 

e 

m 

THIS ROUTINE 

IS CALLED BY THE MACRO ROUTINE "MACCAL" 

004 

m 

w 

"MACCAL" PASSES ONE ARGUMENT> N , TO FORT 


p 

FGPfT ADO® 

1 TO IT AND THEN... 

«0S 

c 




«07 

p 

y 

THIS FORTRAN 

ROUTINE CALLS MACRO PROGRAM SUM 

m a 

p 

y 

TO PERFORM 

SUMMATION OF ARRAY A. 

*09 

p 

w 

THEN THE SUM 

IS PRINTED OUT AFTER T8T*» 


g^s 

y 




*ti 


SUBROUTINE 

FORT CN3 

pis 

p 

y 




013 


INTEGER AC 

1@3 

s TOT 



A C15 ®i 



ES|S 


A CS5 ®0 



$1® 


AC351? 



PI? 


A C43 ®a 



@!@ 


ACS)@§ 



P|@ 


A C©3 ®i© 



W 


AC?mt 



021 


AC8)a|t 



022 


AC91M3 



023 


A Cl@1»J4 



024 

ff 




P2S 


NeN^ i 



026 


call Sum ca 

»N, 

TOT) 

02? 


WRXTECSit n 

TOT 

028 

fa 

w 




©2® 

1 

FORMAT C1M 

9 1 T 

OT» * f1105 • 

030 


RETURN 



03! 


END 





FORTRAN CABLING MACRO EXAMPLE 



/ 1 





082 

C 




003 

C 

THIS ROUTINE IS CALLED BY THE 

MICRO ROUTINE «MACCAU 

mA 

c 

"MACCAL" PASSES ONE ARGUMENT, 

N 1 

TO FORT 

00S 

c 

FORT ADDS 1 TO IT AND THEN,,„ 



mn 

c 




mi 

c 

THIS FORTRAN ROUTINE CALLS MACRO 

PROSRAM SUM 

008 

e 

TO PERFORM SUMMATION OF Af?RA¥ 

A @ 


08i 

c 

THEN THE SUM IS PRINTED OUT AFTER 

tot@ 9 

010 

c 




011 


SUBROUTINE PORT(NJ 




a DSA 

FORT 



00011 


.DA 



00002 

JWR 

100002 



00003 

,034 

N 



mmm 

S @0004 



0ia 

c 




013 


INTEGER A(10)a TOT 



014 


Atli»5 



00004 

CMAICLA 



00005 

tad 




@0@iS 

TAD 

A 



@©@iF 

D AC 

308007 



00018 

US 

C80@@@S 




s 00153 



00011 

0 AC* 

XIA 





A(8)aS 



00018 

cmaicla 



0@0|S 

TAD 

(000002 



00014 

TAD 

A 



@0i|i 

DAS 

300015 



00016 

LAC 

Ciiiii® 



S00018 

If 00 

153 



M§17 

DAO* 

XIA 



016 


A £3)#T 



00550 

cmaicu 



00021 

TAD 

(000003 



®§IP22 

TAD 

A 



00023 

DAC 

$00023 



00004 

UC 

(00000? 



S@@fgS 

e 00153 



00026 

BAG* 

xxa 



01 7 


A(45*8 




CMAICLA 



00027 

TAD 

C®80ii4 



00030 

TAD 

A 



00031 

DAC 




0@i3^ 

LAC 

(000010 



500031 

i MISS 



00033 

0 AC* 

XIA 



018 


A CSS0§ 



@©834 

CMAICLA 



0i03i 

TAD 

(000005 



00036 

TAD 

A 



00037 

OAC 




0 C§ ^ 4 i 

LAC 

(000011 



SG?®i37 

n 00 

1 S3 



00041 

DAC* 

XIA 



012 


A (85 010 



0i@4S 

CMAt 

CLA 







00144 

TAP 

A 

00045 

OAC 

800045 

0ii48 

LAC 

(000012 

Iili4g 

» 00153 

00047 

DAO 

XXA 

i2i 


A C75ill 

mm% 

CHASCLA 

00051 

TAD 

{008807 

0903a 

TAD 

A 

e§@93 

DAC 

si@ai3 

i@0S4 

LAC 

(080013 

$00083 

■ @01S3 

@i@SS 

P AO 

XX A 

021 


A(S}«12 

iiisi 

CMMCU 

amsf 

TAD 

(008810 

@00S@ 

T AO 

A 

mm% 

OAC 

S@fi®6t 

©sfisi 

LAC 


s@@@gi 

« 00100 

i®i@3 

P AO 

HI A 

pgg 


AC25013 

@@®@4 

CMAiCLA 

@0003 

tad 

(000011 

i@iS8 

T AO 

k 

00061* 

DAC 

s»0@sy 

00070 

LAC 

(000013 

000007 

a @@153 

00071 

DAO 

XXA 



AC1®3 H|4 

00078 

CMAICLA 

@i@73 

TAD 

{0§@®18 

@0074 

TAD 

k 

|@@^§ 

DAC 


084 

C 


@@®y® 

LAC 

C0©«@16 

i@@0?S 

« MISS 

@i®77 

DAC® 

XXA 

02S 


NnN+1 

00100 

LAC® 

N 

00101 

TAD 

(000001 

00100 

one* 

N 

@gg 


GALL SUM 

@i!33 

JMS® 

SUN 

§®1®4 

JMP 

00110 

@@1®§ 

@ 08 A 

4300180 *A 

58186 

e OS A 

400000 + W 

B8187 

,P8A 

TOT 

027 


WRlfgCi® 

@0118 

JM0* 

@ FN 

00111 

@ 0iA 

Ciii@«Q 

001 is 

s DSA 

a 1 

^ga 

m 


08113 

a DS A 

ffffff 

•00114 

JMS® 

@ FE 

0011§ 

s D8 A 

TOT 

00116 

JMS# 

a F P 

ptgi 

1 

FORMAT £ 1 


N ■ TOT) 


f TOTi 1 1110! 


TWWJTT 



80181 

min 

®@II3 
§9124 
§@128 
00186 
iiil 17 
©ii! if 

mim 

031 

mm 

m%m 

00138 
@@146 
®i!4i 
@@14? 
00190 
00191 
00182 
00133 
00184 
iiISS 
@0iss 
00197 
00160 
00161 
@i|6S 
00IS3 
0ili4 
iii@e 
00108 
@@i 87 
00170 
00171 
06178 
00173 
m%?4 



@ D8A 020130 
@ 0§A 23SSII 
@ 08A Fig178 
®DSA 839311 
0 D@A 130140 
^OSA 245004 
■D8A 020100 

• 00130 

RETURN 

JMP .IK 

INP 

JMP* 00000 

t esA s qa 

@0LK iiiill 

9 o§a 0@§®@i 
f bsa 000019 
0 P§A 000000 
9 DSA i®0@®IS 
g 0 S A A 

• BLK @ii|@| 
0 B^K 000001 
@ OSA SUM 

0 os a ,rw 

@ 0SA a ft 
,DSA a PF 
9 0§A 000001 
@ DlA @®0@®8 

@08A mmm 

e DSA @00®0i 
@ 08A 000003 

8 dsa mmm 

f 08A @@0004 
,BSA 

0 dsa aiiiii 
@ 0SA 000018 

.os h 

§ ogA 000014 

e 0SA 000019 . 
0 ©sa ©@®ei@ 
1777? 

00132 
0® S3® 3 
0® |Si 
00183 
00IS8 
iiiss 
i@|S4 



PAGE 1 


MACEX SBC MACRO FROM FORTRAN EXAMPLE 

.title macro from fortran example 

i 

t PROGRAM IS CALLED 8Y fortran routine to 

/ SUM ELEMENTS OF AN ARRAY«»»IT RETURNS THE 

/ SUM IN A LOCATION WHOSE ABDRE88 19 PASSED. 

/ 

.SLOBL SUM,.OA 


00000 

R 

IflifW 

A 

SUM 

i 





00001 

n 


E 


JMI# DA 





m%m 

n 

mmm 

R 


JHF ,44 





00003 

R 

000000 

A 

AR81 

0 / ADOIISS 

OP 

ARRAV A 



i 

R 

mmm 

A 

AR08 

i / AOORI8® 

OP 

LOCATION 

CONTAININg 

VALUE N 


R 

000000 

k 

AR63 

i 

0 7ADDRESS 

OF 

LOCATION 

WHERE SUN 

IS RETUR 

MM 

r 


R 


LAC* A R © § 




'Ww 

mm7 

R 

740031 

4 


T£ A 





m$i§ 

R 

040004 

8 

s 

DAO ARM 





@@0I! 

R 

mmm 

A 


CIA 





00 ® is 

R 

3S3003 

R 

ADDER 

TAD* kmi 




< ^bte nv ■" 

08013 

R 

44i@0§ 



xsz km% 





30014 

R 

440004 

R 


18Z A«t 





mm s 

if 

880018 

R 


JMR ADDER 





00018 

R 

mmm 

R 


DAO* ARDl 






R 

6g@00@ 

R 

J 

JMP* SUM 







000000 

A 

/ 

®end 





0®@i@ 

R 

mmm 

SE *6 









SIZEMiJMI 

NO ERROR LINES 







$A LP -12/DK -13 


PDAT 


.DAT 

DEVICE 

U1C 

USE 

-15 

DKA 

PES 

OUTPUT 

-14 

DKA 

PES 

INPUT 

-12 

TTA 

PES 

LISTING 

-1 0 

TTA 

PES 

SECONDARY INPUT 


**sM«***********^*************** 
CREATING A LIBRARY WITH UPDATE 
******************************** 


UPDATE V3A0 
>NL«-USERLB 




CONTAINS THREE BINARY PROGRAMS 






fC 


DOS-I 5 V3A000 
$PA6E ON 


making use of libraries 


® LOAD 


WITH THE LINKING LOADER 


.DAT 

DEVICE 

UIC 

USE 


NON 

PES 

USER LIBR 

®4 

0KA 

PES 

USER PROG(S) 

-1 

DKA 

SYS 

SYS LIBR 


sfe sfs sf« sje sje 4c ^ ^ ^ sfg s|£ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ 


SK ON 
SLOAD 


ALL THREE FILES '■' SPECIFIED® 
NONE PULLED FROM A LIBRARY ® 


1,2.3, 

2 ®0 

DOS-15 V3A000 
SLOAD 

LOADER V3A000 
»P«-AVGLOB : ► 

P AVGLOB SRC 77503 
p CRLF SRC 77474 
P PRINT SRC 77467 
tS tS 
3 , 4,5 , 

4 @ 0 


ONLY ONE FILE SPECIFIED• 

THE OTHER TWO PROGRAMS--CRLF AND PR I NT- 
ARE PULLED FROM THE USER LIBRARY .LIBR 5 

automatically. 


LOADER V3A000 
>P#»A VGLOB , CR LF, PR I NT 
P AVGLOB SRC 77503 
P CRLF SRC 77474 
P PRINT SRC 77467 
t SfS 
3 , 4,6, 

4.3 


DOS-15 V3A000 
SLOAD 


LOADER V3A000 

>P«-MAIN im# THE FILE SPECIFIED IS A LIBRARY® 

P AVGLOB SRC 77503 EVERY PROGRAM IN THE LIBRARY IS LOADED • 

P CRLF SRC 77474 

P PRINT SRC 77467 

tStS 

3,4,5 $ 

4.0 


DOS-15 V3A000 
SLOAD 


LOADER V3A300 
AVGLOB ? PHI NT 
P AVGLOB SRC 77503 
P PRINT SRC 77476 
P CRLF SRC 77467 
*S tS 

3 , 4 , 5 .., ._.. 


TWO FILES (PROGRAMS) ARE SPECIFIED® 
THE THIRD PROGRAM — CRLF — 

is automatically pulled from the 

USER LIBRARY .LIBR5. 




LOADER V3A000 
>P*=AVGL03 t USER L3 @ PR I NX 
P AVGLOB SRC 77503 
P CRIF SRC 77474 
P PRINT SRC 77467 


►THREE FILES ARE SPECIFIED• 

THE FILE AVGLOB CONTAINS ONE PROGRAM (AVGLOB) 
THE USER LIBRARY USERL3 CONTAINS ONE 
PRQGRAM--CRLF—. 

THE FILE PRINT CONTAINS ONE PROGRAM (PRINT) • 



References: 




DOS USERS GUIDE 8-30 

DOS KEYBOARD COMMAND GUIDE 11 


BOS-1 5 V3A000 
SL 

*5Me**************************************************************** 

PHEPAR 116 A BATCH STREAM 

S? 

:$?******* ***************%****************************** 



“\ 


$ED1T 



EDITOR W3A000 
>OPEW BAXSIR 

FILE BATSTR SRC WOT FOUND* 
INPUT 
^ SJ 03 
PIP 

L LP «- DK <SCR > 

L LP FILBLK BIN *- DK (P) 

$J OB 

A LP ”12 
MACRO 
BLG^ME 
$J OB 

- GLOAD 
P<*“ME 
$EXI T 


EDIT 
>; >EXIT 


DOS-15 V3A000 
SL 

******************************************************************* 
GETTING THE BATCH STREAM OUT ON PAPER TAPE 


SPIP 

DOSPIP V3A000 

>T PP «- DK BATSTR SRC 



A a. CL 


SMACRO 

MACRO-15 V3A000 
>B LG«“ME 


END OF PASS 1 

SIZE = 00025 NO ERROR LINES 

MACRO-!5 V3A000 
>$JOB 

DOS-15 V3A000 
SGLOAD 

LOADER V3A000 
P*-ME 
ME 

LPA • 15 


SRC 77612 







DISK FILE FORMAT FOR DOS 




1ST BLK 



2ND BLK 






A©e i 


9L0CK 


me PROGRAM TO HIT ON IT 8L0CII IN A FILE ON OAT 8 


sTitle mmnm to list on tt blocks in a pile on 

/ 

/ 

/ 99999999999999999999999909999990999999999999999999999 G 9 ' 

/ 

^nomm lists on the teletype im slocks usid by a file 
/STORED ON THE DgVlCS ASI0CIAT18 WITH DAT 8 @ 

/USER HUST KNOW THg STARTSN® §LOC« NUMBER CSIVgN SV PIP 
/ON EJY DIRECTORY Si QBTAXMGD if U01N0 THE m IWJTCH 

/for DiiscToRv m mm, n tt § otc mi 

/WHIN PSQIiAM HALTS* PLACE THt NUHSIPi 0P THE FIRST BLOCK 
/USED IV THE FILE IN THE DATA IWTOHiS AND THSN HIT THE 
/CQNTINU8 SWITCH^ 


/09999999999990999999999999990999099999999999999999O99f M \ 

/ 


ffi SODgV B 

/ 

i0ii© ft 7B??m A START 06A ' /MAKE SURE IN RASE HOOF ' 

•XNIT -SpliR /INITIALIZE DEVICES 

•XNXT i®@ 0 @ 

/ 

/®|T SLOCK NUNSift AND FILL IT IN APPROPRIATE WORD OF 
/ e TRAN EXPANSION, 


10011 R F4ii4® 
00012 R 7B0S04 
00013 R 04@SifF 


HLT 

LAS 

QAC TRAN 


/REAS IN BLOCK MUMS E R -— 
/FROM DATA SWITCHES 
/PUT IN .TRAN EXPANSION 

/block # position 


/PRINT OUT StOCK U 


/ 

0001S R TRAN .TRAN 8.0.0,BURR»886 /BO .TRAN 

.WAIT 8 

/ 

/•***#**•***###•*•**###*#•##•*#*♦•****#***#*•#***##*###* 
/CHECK THI UA8T WORD IN THg BLOCK JUST READ IN, 

/SR THIS WORD ■ 777777, THEN TMS S18CK JUST READ I® THE' 
/IN THI PILE. 

/IP THIS WORD NOT s 777777, THEN IT IS THE NUMBER OR TH 
/BLOCK USED B¥ THIS RILE. 


66034 R 200413 
00028 8 3404/S 
00028 R 000088 
9003/ R 190033 


LAC BURFrSRT 
SAO 1777777 
JMR ENORIU 
JMS PRINT 


/PICK UP WORD m IN BIK 
/LAST PILE Bl*t7ff777)7 
/YES 

/N0.RRINT OUT BLOCK « 




pasi a 


BtOCK 


$pte 






/###*###♦***###*•*•******.****•*******■*•***■*♦■* ******* **'**** 
/S|T HIRi $HSN THERE ARI Still MORI 8106X8. TO THf. Fill, ' 
/PICK UP THE NEXT BLOCK NUMBli FROM WTOD jW7 8F FILE., 
/PLACE IT IN THf APPROPRIATE 'WOIB IN THE .TRAN EXPA-N3T,0‘N 
/THIN SO 00 TNI ,TIUN 

/ioeoa®******®#***®***#*®*®**#®®**®***®**®*®®*®*®***®**** 


B0038 R 800478 
@8031 R 040017 
@0033 8 8@0@IB 


LAC BUFF+3F? /SET UP TO TRAN IN NEXT 

0A6 THAN^g 

JMP T8AN /DO NEXT TfiAN 


/ • • 

/****0****#*0***************************************** 
/eONVSR? i OCTAL 0ISIT8 TO 0 ASCII CHARACTER® 
/#-*#♦#****#*#*#♦#♦#♦*♦#*#**♦**********•*♦*****♦*’******** 



9RS39 r W®M 
@i®36 R 8004F4 
■> 00037 R 7ES00B 
00i40 R 780000 
i@041 ft @4§iOT 
80148 R 3414^8 
00043 R 0S®@®3 
§0044 R ^iSi0| 
@®04i R §@i@4@ 



PRINT i 

IMS 

clx 

lac e@ 
pal 

NMT CLA 

III 3 
TAO CiS 
oac buppo^SsK 
AMS I 
JMF NXY 

/ 

/a****************************************************** 
/OUTPUT SLOCK # 

/#*##****♦*♦*##♦••■##•##♦****•*•♦••****•*******♦*•******• 

/ 

»NRJTE ®3#3i®UPP0@8 
gNAlT «3 
4HF* PRINT 



/**#****###•*##**#**#***#•****#•**♦********************* 
/ON END OP FILEi CLOSE BAT »3 ANB RETURN T0 MONITOR ;. . 




.OIOS 
• EXIT 


mmi 

R 

MS ®§3 

/l 


suppo 

@00903 


00068 

R 

iiiii® 

A 



8 


@i®@3 

R 


A 



.BLOCK 

i 

00071 

R 

iiiili 

A 



18 


00072 

R 

iii@li 

A 



12 


00073 

R 


A 


/ 

buff 

§ 

.BLOCK 

4®i 



liiii® 

R 


i v 

.END ST 

Jiff? 


R 

777777 

A 

*1 




mM?4 

R 

mmm 

A 

*1 




m4?§ 

i 

iiiaii 

A 

*L 






8XZE«00470 

NO ERROR 

UNIS 




EXAMPLE OF ONE BLOCK OF A FILEi 



HEADER WORD 1 


‘DATA 


HEADER WORD 


HEADER ■ WORD 1 


HEADER WORD Sf 


HEADER WORD 1 


DATA 16 


MKT BLOCK OR (-1) 









BIT MAPS 


BLOCKS 71 THROUGH 77 MAINTAIN INDIVIDUAL BIT MAPS FOR ALL FILES 
ON DECTAPE © 


BIT MAP FILE RELATION I 



BLOCK 

71 

pi M 0> 


BLOCK 

77 


THE INCLUSIVE n OR” OF ALL INDIVIDUAL BIT MAPS IS EQUIVALENT TO 
THE MASTER BIT MAP® 



























































030114 

aSIXBT ? »CALH@@SRC” 

1 

100000 

© 

© 

. 1 

232203 

© 

© 


001645 

FIRST BLOCK OF THIS FILE 
(BIT 0 = TRUNCATION) 


000002 

SIZE OF FILE IN BLOCKS 

$ 

001764 

POINTER TO RIB BLOCK 

1 

200232 

FILE PROTECTION CODE (0-2); 
LOCATION OF RIB 

START 1 

1423®'”''' 

DATE FILE CREATED (12-21-71) p 

170623 

•SIXBT s, OFSCLKLST ,f 

. 

1 031413 

© 


| 142324 

© 

© 

_____ 

"002045 ' 

FIRST BLOCK OF THIS FILE 


000116 

SIZE OF FILE IN BLOCKS 


001643 

POINTER TO RIB BLOCK 


200000 

FILE PROTECTION CODE (0-2) 
START LOCATION OF .RIB 

AND ■ 

142501 

DATE FILE CREATED 
(12-21-71) 



PROTECTION CODE? (Valid only if directory is protected) 

1 = Unprotected^ 2 = Write Prot®, 3~R/W Prot 


*RIB: The RIB may occupy its own block or, If roo m 9 occupy 

an area at the end of the file it Is describing® 




tc 


DOS“I 5 V3A300 
$A IT -12 


$A DK - 1 4 



SDUMP 


DUMP V3A000 

>1777# 


1777# 

MFD 


/ 1-1 7 p 


C/ttz /OS 




0 

T 7 T T T 7 

777777 

000034 

401776 

/111 723 j 

000053 

400010 

000000 

10 

2013.107,/ 

0000£6 

400010 

000000 

021613 

000064 

400010 

000000 

20 

230322 

001461 

000010 

000000 

020410 

000653 

000010 

000000 

30 

200523 

001451 \ 

000010 

000000 

221310 

001733 

000013 

000000 

40 

TO 

367 \ 

CONTAINS 000000 



mm 

370 

000000 

000000 

i000000 

000000 

000000 

000000 

777777 

DUMP V3A000 








>1776# 


£'JV.'S ^ 


7a me. 





1 776# 

SAT 

« 







0 

004000 

004000 : 

002432 

min 

mm 

777777 

111111 

mm 

10 

TO 
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000000 
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062416 

611516 

021116 

001455 

000001 

001455 

200152 

030305 

1 0 

0425 15 

000000 

021116 

001457 

00000 1 

001457 

200066 

030305 

20 

042515 
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300324 

001465 
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001465 

200026 ‘ 
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042515 
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300325 

001467 
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TO 
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mm 
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370 

000000 

000000 

000000 
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000000 
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DUMP V3A000 
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PATCH 


SUBJECTS DOS-15 PATCH TO DUMP V9A 


The following patch corrects a problem in DUMP which outputs incorrect 
information on selective dumps e 


LOCATION 

OLD CONTENTS 

NEW CONTENTS 

NEW SYMBOLIC 

COMMENTS 

16256 

217406 

617472 

JMP PATCH 

/Patch area 

17472 

« 

116034 

JMS DEVICE 

/Device check 

17473 

- 

217406 

LAC (-1) 

/Restore lust 

17474 


616257 

JMP. BACK 

/Return 

17224 

106400 

206400 




DOS-15 VIA 
$MICLOG SYS 

$DUMP 


DUMP V9A 

tc 

$R PATCH 


DAT 

DEVICE 

UIC 

USE 


*14 

DKA 

SYS 

I/O - SYS 

DEV 

10 

TXA 

SYS 

SECONDARY 

INPUT 


$ PATCH 

PATCH V10A 

> DUMP 

>L 16256 

>16256/217406> 617472 
16257 / 057172 > 

> L 17472 

>17472/215116> 116034 
17473/253512> 2X7406 
17474/055116>616257 
17475/214753> 

>L 17224 

>17224/106400>206400 

>EXIT 


DOS-15 VIA 
$DUMP 

DUMP V9B 
> 
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the INFORMATION IN THIS DOCUMENT II SUBJiCT TO 
CHAN8E WITHOUT NOTIOI AND SHOULD NOT BS CONSTRUED 
AS A COMMITMENT IT DI81TAL EiUlPMENT CORPORATI6N S 
OIS1YAL IIUIPNENT CORPORATION A8SUM8S NO RESPON® 
9XB1LXTY FOR ANT SRROR1 THAT MAT APPEAR IN THIS 
document* 

THE SOFTWARE DESCRIBED IN THIS DOCUMENT IS *U»U 
NI8HED TO THE PURCHASER UNDER A IXCENSt FDR USE ON 
A SINfiLE COMPUTER SYSTIM AND CAN II COPIED CWITH 
INCLUSION OP DIQXTAL'S C0PV8I6HT NOTICE) ONLY FDR 
USE IN SUCH SYSTEM® EKCRPT AS MAY OTHERWISE BE FRO® 
VIDEO IN WRITINS Bi DIGITAL. > 

OISITAL EQUIPMENT CORPORATION ASSUMES N© fiE9P0N8IBf 11Y 
FOR THE USE OR RELIABILITY 8P ITS SOFTWARE ON EQUIP® 
HENT THAT IS NOT SUPPLIED BY B1®ITAL 8 

COPYRIGHT CC3 1§?4 S BY DIGITAL EQUIPMENT CORPORATION 
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/copvrxdht im§. $ cubital equipment corr’., maynard. mass c 

/mb, 

/PRSgBlOPl PAPER TAPI READER HANDLER • « IQPi 41611 ,¥ a 

>M, BXPNAB/J, MURPHY 

'/7*3®*0t 

/6AUIN6 SEQUENCE I 
/e1NIT 

/CAL+«OAT 8L0TCi®IF! 

n 

/B , -- ' 

/i 


/*REAi 
/GAL*! 
/!« 
/UNI 
/®we i 


iQR b 

Ci* 


su 




mmm 

A 

t RBDn3 





708101 

A 

RSP>700101 




700108 

A 

RCP0700102 




790118 

.A - 

RRBMG0U2 




780104 

A 

RSAr700104 




700144 

A 

R 3 9 8 y 2 0 
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.&U)3L PSB, 

$0000 

R 

040540 

0 

PiS a 

DAO 

mtkiP 

0000 ! 

R 

040341 

R 


SAG 

prarbp 

00002 

R 

440341 

R 


III 

PRARBP 

00003 

R 

220341 

R 


LAC# 

PRARiP 

006li*f 

8 

442341 

0 


111 

PRAR8P 

00005 

R 

340422 

...ft. 


TAP 

CJHP PiTAiL 

CS@0ig 

R 

2 4 @ ® 14 

0 


DAC 

PRTA91 

?ta®p7 

R 

700314 

A 


I0RS 


00010 

Pi 

yss!0@ 

ik 


8 MAI6LA /AS PUNi 

0001 i 

R 

77774® 

A 


LAW 

1774S 

09012 

R 

§4@|f3® 

R 


TAD 

PRION 

0 0013 

PI 

04®0§g 

R 


DAC 

PRDBK 

00014 

R 

74004® 

A 

PRTA8L 



00013 

R 

620031 

0 


JMP 

PRXN 

00013 

R 

F4i®00 

A 


NOP 


00017 

R 

iiisss 

R 


,?MP 

mmm 

00080 

R 

«@®@87 

0 


JMP 

prer6 

00021 

R 

iiii27 

R 


JMP 

mtm 

00022 

R 

60R043 

0 


JMP 

pmk it 

00023 

R 

100032 

R 


JMP 

PRDBK 

00024 

ft 

6 0 ® § 7 8 

R 


jnp 

prr m 

00025 

R 

800027 

0 


JMP 

PRIRS 

mm i 

R 

600000 

0 


JMP 

PftWATi 

$1127 

R 

700000 

A 

PigPte 

LAW 

S 

8 MS if 

R 

ii®4S3 

0 


4HR* C a MgD*i 


/6AL POINTER 
>R8 POINTER 
NDEX T9 FUNCTION AS 
'UNCTION 


SIT SQNalSF SWITCH 

'ION 0P ITS STATE 

’ON ENTif INTO CAL LEW 


\' p OELET $ , R E N A M» ® 
i.SRBK • X6NQRED* 
/4@ s |NTER 
/§© @ CLEAR 
/Si.CLOSi 
/7i,MTAPE ® 
/ii®@REAS 
/I |i@WRITE 
/ibo.wax? m 


WAITR f 
AD0ft I'N @ Mfc! 



PA6E 3 


pm, 





ft 

440341 

ft 

PRIN 

111 

P8AR5P 

@0138 

ft 

200424 

R 


LAC 

Ci4 

@0@31 

R 

l®@341 

R 


OAC^ 

mmm 

@@134 

ft 

441341 

R 


111 

mmm 

@®@3§ 

R 

a@i@s@ 

Is 


SAL 

m 

illli 

ft 

sisiii 

4 

PfttiNP 

10 


mm? 

ft 

711101 

ik 

PftOIP 

ftlp 


00040 

r 

118140 

ft 

PARIS 

PTRINT 

00041 

ft 

1@®@43 

ft 

PftUND 

LAC 

a ^8 

@0042 

R 

i4®@SB 

R 

PTPtWG 

BAG 

9 «S 

@0043 

ft 

6@i@44 

ft 

PffCHAR 
/STOP ! 

JMP PR8T0P 
PTR ROUTINE* 

@@@44 

R 

141041 

R 

RRST0P DIM 
/PTR WAIT 

PRUND 

|0@4i 

ft 

211041 

ft 

PPtWAIT 

LAC 

PRUNO 


®@@4® 

00047 

®®iSi 

«@®SI 

®0asg 

®iiS4 

00065 

@®@86 

mm? 

®0®i@ 

00061 

®0l®i 

80003 

10064 

00065 

@0806 

00067 

00070 

0®@7l 

ga®7i 

gs@@73 

0ii74 


ft 

R 

R 

ft 

R 

R 

ft 

R 

R 

ft 

R 

ft 

R 

ft 

ft 

R 

ft 

ft 

ft 

ft 

R 

R 

R 


741200 

ig®®34@ 

@4®34t 

74§§4§ 

703344 

4iii§e 

liiS4l 

iiiiis 

440341 

000062 

7iii©i 

fS2@S4@ 

?4nm 

2@i84@ 

800485 

040340 

211141 

i3i®4a© 

240340 

C14IS40 

4411341 

§§§§4§ 


@@®7S R 200041 


00101 

@®1®2 

@@f@3 

00104 

02105 

00106 


%mm\ 

@40131 

22034: 

®4®@a: 

@4@S§3i 

44034 


PROMS 

PiN^TR 


mm TO BUFFER 


/STANDARD lUFFIi SXZE«I 
7INDIM TO RITURN ADDR8I 
/API A0B8» » ONCE ONLY CODE. Tl 
/.SETUP «> L.B.H‘. POINTER. 

/ m BATA W8S0 POINTER 

/PARITY ERROR SWITCH 
/ . 1/6 UNDERWAY 
/ « gl’S C0MP WORD £OUN? 

/ > CHAR PROCESSED 
CUEARXNS 1/0 SWITCH 
/CLEAR S/0 


JMP* PRAR0I 


'RCAI.P 

'SCALP 

PRARSI 

7777? 

'RCALP 

'SCALP 

iRAHSP 


/STAR' 

PRSTS 


'RNEXI 


/STILL REA0IN3 


>U8Y'. RETURN 
0 USER CAL, 
:@n OP IBP 
• BSiEAR PROM 


VEL AND REST 




S2A1CMA /NO 

jmp psausv 

UP PTR 
BAG PRUNO 
LAC PRDBKI 
BAG PTROUT 
LAE® PRARSP 
DAE PRBBP 
DAE PRUBHP 
IS! PRARSP 
PRAR8P 


NONoiUS' 


/I/O UNDERWAY? 

START IT UP 

/YES-WAIT IN BUSY LOOP SACK TO 

/iBT I/O UNDERWAY SWITCH T7777: 
/ESI? TO USER-MAINSTREAM 


/L.8.H POINTER I' 
/L.B.H. POINTER 



10110 

R 

mmm 

R 

00111 

R 

440341 

0 

00112 

R 

?e?®m 

A 

00113 

R 

9t©340 

R 

0® 114 

R 

S4I487 

R 

00116 

R 

ii@18@ 

R 

mne 

R 


A 

mu? 

R 

§g@413 

R 

00120 

8 

2S0430 

ft 

min 

R 

040347 

R 

lem 

R 

100317 

R 

mini 

R 

100317 

R 

mvn 

R 

777773 

A 

00128 

R 

040344 

R 

00120 

R 

148346 

R 

$©187 

R 

14®2*4§ 

R 

00130 

R 

umm 

R 

0®131 

i 

immu 

A 

00132 

R 

800431 

ft 

20133 

R 

?mm% 

A 

mim 

ft 

mm?u 

R 

MW 

R 

700002 

A 

00136 

R 

700104 

A 

00137 

R 

74®@4@ 

A 

00140 

R 

600191 

r 

00141 

R 

©4134S 

R 

00142 

R 

umim 

R 

00143 

R 

040343 

R 

00144 

R 

7i@ai4 

A 

0014$ 

R 

78ilii 

A 

0i|4i 

R 

7777 M 

A 

00147 

R 

34ilS0 

R 

00180 

R 

600185 

fS 

ff 

0®15| 

R 

040342 

1 

00182 

R 

820438 

R 

i@!03 

R 

040343 

R 

00154 

R 

200166! 

ft 

§®!S§ 

R 

@4i35S 

R 

0018@ 

R 

700112 

A 

00187 

R 

i4§®43 

ft 

00180 

if 

700042 

A 

00181 

R 

mim 

ft 

@0i@g 

R 

®40137 

ft 

00103 

8 

200041 

R 

00164 

R 

741200 

A 

00168 

R 

6008©® 

ft 

we© 

R 

700314 

A 

10167 

R 

50043! 

R 

i©!7@ 

R 

741100 

A 

00171 

R 

8S®S@? 

R 


QAC PTRWe 
m PRARS^ 
IAN 7(300 
AND* PRCALI 
SAD (MM 
JMP ,*s 
LAN 7 

JMP* (.MED, 


'•l.b'.w.C. ea*s eoMpj 
'INDEX TO POXNT TO EXIT 

/CHEEK PQR SOPS ASCI» MO 


■ LLSQAL DATA MODE 


f WD a 

>1 roi 


je 


JM8 PRNKWB 

jm@ mmm 

pnm law mn 

DAS PTRB7 

DIM PRCCT /CLEAR 

DIM FRICT /CLEAR 

0 tn PARER /CLEAR 

PfiOUTi X0R8 

AND C10WS 
SI A 

JMP RRgOM 

IDF 

PISA 

PfROUT XX /JMP PRD8IS OR JMP FRDISM 

/PTR INTERRUPT SERVICE 

PfRXN? JMP PTRPIC /PIC ENTRY 

OAC PTRAC /API ENTRY(3 SAVE 

LAC PTRIN? /PIC OR API@ L» i 

DAC PROMT 

xors 

SMAICLA 
LAW I 7 ?m 
TAD PRION 
JMP PRSION 
PTRPSC DA6 PTRAC 

LAC^ C@ fPICmP 
DAG PRGUT 
LAC PRION 
PftSIGN DA6 FftiW 

n ®I /READ PTR SUPFE 

DAg PR6NAR 


DATA MOOi 

NEADI 


AN 


/IOPS 

ift e?» or 

gAOEft, 

/iNoen past lIb* 

/FOR IOPS ASCII 
/8/7 CHAR 
/COUNTER 
HAi 6Y@ 

SCII ITH BIT SET COUNTER 
ARXTY SRP? 0 SWITCH 


/SAVE AC 
Id EM g MP 
/SAVE FQP! El 


ION 

LAB PRPSMI 
DAO PTROUT 
LAg PRUNO 
SNA 

W P80ISH 
IQRi 

ANB Cilii 


fm STOP SINCE 


/ISNOig LAST Rl 
NOT iEASYf £X0R98< 



PASS 

S 


PR§ @ 

000 

fiftic 

1 







/END OF 

p AP£ 

R TAPE fl 

/*V 

mi?z 

R 

881433 

R 

PRIQH 

LAC 

CIS 


mm 

R 

g4li«S3 

ft 


BAG 

PRCHAR 


00174 

R 

S0®4g3 

R 


LAG 

C4 



R 

34i84? 

R 


TAD 

prdtst 



R 

§4034? 

R 


0AC 

FRBT6T 


mm 

R 

&mm? 

R 


JMP 

RRRA 0 


@0|@@ 

R 


R 

PRDI1M 

LAG 

PTiAG 


00201 

R 

mnmz 

R 


MCI 

P«SW 


mmi 

R 

703344 

A 


QBR 



mmi 

R 

401204 

R 


ttCT 

■ + i 


0it@4 

R 

611343 

R 


JMP# 

PROUT 






/END UNI 



@0^05 

R 

141041 

R 

prxobb 

DIM 

PRUND 


i0g®8 

i 

40013? 

R 


KCT 

PTiOUT 

1 \ 





/Resells 10PS ASCII 


00207 

R 

gti@4i 

R 

P810A 

LAC 

PTRWG 


aigli 

n 

740100 

A 


SMA 


"1 

®iiii 

R 

a$ffig?? 

R 


JHP 

PHASES 






/CQMPUT 

6 PARITY AND 


®a2i2 

R 

11711% 

A 


LAW 

|??7@ 


18213 

R 

i4@8Si 

R 


DAG 

PRCNT 


mz 14 

n 

140351 

R 


DIM 

PRCNTI 


0021 s 

R 

g@®043 

R 


LAC 

PRCMAR 


0®gl@ 

R 

Sii484 

R 


AND 

(177 


8igi? 

R 

040435 

R 


SAD 

C12 


00220 

R 

000131 

R 


JHR 

PRSUT2 

\ 

00221 

R 

84043S 

R 


SAD 

(13 


00222 

R 

800131 

R 


w 

PR0UT2 


88228 

R 


pi 


SAD 

(14 


80224 

R 

800181 

R 


JMR 

PR0UT2 


00229 

R 

110043 



LAC 

PRCHAft 


Mass 

R 

74120® 

A 


SNA 



mm 

R 

000131 

R 


JMP 

PR0UT8 


00230 

R 

?4i@2i 

A 


RAR 



00231 

R 

?4|4SS® 

A 


S1L 



0023® 

R 

448S81 

R 


xbz 

PRGNT1 


@0g33 

R 

44SSS0 

R 


f&l 

PftCNT 


80234 

R 

®§®88® 

R 


JMP 

ffl ss>4 


00135 

R 

7414®® 

A 


S1L 



00236 

R 

440346 

R 


181 

PRSCT 


@0237 

R 

44®34@ 

R 


111 

PRCCT 


18240 

R 

gilSSl 

R 

RRIOM 

LAC 

PRCNT1 


10241 

R 

74ii8@ 

A 


RAR 



00242 

R 

741 4m 

A 


821 




R 

440040 

R 


111 

PAPES 


®Sg44 

R 

irnirn 

R 


JNS 

PREN0T 


00249 

R 

800434 

R 


AND 

Ci7? 


00248 

R 

S4i434 

R 


SAD 

CST7 


i@24? 

R 

000131 

R 


JMP 

P8BUTS 


00230 

R 

I008SS 

R 


j m 

RRPK5? 


00281 

R 

iMMi 

R 


jm 

PREN0T 


/CUBAN 1/0 UNDERWAY 
/EAKE 9UT END 9F LINE TEST 
/CHAN6E MOSS 
/TO S0M 


E R 0 M H A N U L fc ^ L E V K L» 


/CLEAR INPUT UNBiPWAY INDICATOR 
/EXIT 


/see ir excess bat* 


/YE8-«oG0NTINUE UNTIL C'. 

KIT if NULL 

/PARITY COUNTER C®83 


/isnqri up 

/I8N8RE YT 
/XQNORS ?¥ 


fl BIT COUNTER 


/8?H BIT*11 AOD TO COUNT 
/RARITY CSUNf"SHOULD BE EVEN 


/NO? EVEN PARITY 
/CONVERT ALTM0BE8 
/DROP ALL BUT ? SITS , 
/DELETE CODE tRUBOUTJ «SSNORE 

/RACK INTO L.B, IN S/T 



0igS3 

R 

008131 

R 


JNP 

PRQUTt 

00894 

R 

200340 

R 


LAC 

PiCCT 

®0SSS 

R 

34@44i 

R 


SAD 

Cl 

20286 

R 

801184 

R 


JMF 

PPtiCil 

80257 

R 

103344 

i 

P^PAO 

LAC 

pmB? 

20262 

R 

S4i41S 

R 


SIB 

PSSCNT 

sagfii 

R 

SilSiS 

R 


JMF 

PHASE 

008@t 

R 

7§@i@f? 

A 


CLA 


iig63 

R 

1003S3 

R 


JMS 

prpks? 

00164 

R 

S@@gS7 

R 


JMR 

PRPA9 





/END OP 

p 10PS 

ASCII L 

20205 

R 

giiS47 

R 

PRASE 

LAC 

PIDTGT 

3026S 

R 

180036 

R 


940* 

PRLiHP 

20207 

R 

mmm 

R 


LAg 

pmti 

iii7i 

R 

§4®14S 

R 


SAD 

PRCCT 

ii87i 

R 

siii?7 

R 


JMf® 

PRASI3 

iig?g 

R 

200 

R 

PPf 

LAC 

pmm 

22278 

R 

?m2m 

4 


82 A 

/NO 

10274 

R 

200441 

R 


LAC 

Cii /YES 

i®2?5 

R 

260036 

R 

PRASS4 

XOR® 

PRLBMR 

00270 

R 

i@i@§6 

R 


DAG® 

FRLSMP 

mzn 

R 

l®i3S4 

en 

R 

PRA8I3 

JMS 

PPiiNOT 

0i3@£l 

R 

70112! 

A 


8PASSLAICMA 

00301 

R 

0@igig 

R 


JMF 

PRI0S8 


R 

34003? 

a 

R 


TAD 

PROBP 

00303 

R 

§mm? 

R 


DAG 

PRDIP 

20364 

R 

f??m§ 

A 


LAW 

17400 

00309 

R 

32003? 

R 


AND® 

PRDSP 

II3IS 

R 

34i44| 

R 


XOR 

C33 

20307 

R 

i@@037 

R 


OAC* 

PRP8P 

©0310 

R 

44003? 

R 


III 

PRDIP 

00311 

R 

220036 

R 


LAC® 

PPL8HP 

00312 

R 

Si3©443 

R 


AND 

Cii 

§0313 

8 

740200 

k 


S1A 


@0314 

R 

900131 

R 


JMP 

PR0UT8 

I031S 

R 

200443 

R 


LAC 

CSi 

00310 

R 

8«®27S 

R 


JMP 

PRA$|4 

Ii317 

R 

0 @ 8 @ ® 0 

A 

PRNXWD 

i 


00320 

R 

44003? 



IS! 

PROBP 

00121 

R 

4 4 if 2 4 ft 

R 


I®1 

PTRWg 

10332 

R 

62031? 

R 


JNP® 

mmm 

§®32 3 

R 

fl@0fti§ 

R 


JMP 

mmt 
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INTRODUCTION 


This guide describes in more detail, the UNICHANNEL 15 operation and 
features presented in the RK15 Disk Cartridge System Option Bulletin 

The first section .....presents a look at the UC15 system architec¬ 
ture. 

The second section.....describes the PIREX montior system! how to 
use it and other software aids. 

The final section...... provides, for those interested in creating 

their own programs, a complete hardware specification including IOT 
and register descriptions. 

Supplementing this guide are two manuals; 

Unichannel 15 System Maintenance Manual:..DEC-15-HUCMA-B-D 

UC15 Software Manual; ...DEC-15-XUCMA-A-D 

The maintenance manual describes the details of the MX15-B and the 
DR15-C logic and gives maintenance details. 

The software manual describes the details of the PIREX Monitor. 
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UNICHANNEL “15 HARDWARE ARCHITECTURE 


The term UNICHANNEL was created because it emphasizes the union of 
Digital 9 s UNIBUS with the big computer concept of the programmable 
I/O channel* UNICHANNEL 15 unites low cost # mass produced periph¬ 
erals with big computer software and performance on the PDF-15• 

UNICHANNEL 15 (UC15) is a peripheral processor for the PDP-15 util 
izing the PDP-11/05 minicomputer. It provides the PDP-15 with a 
second general purpose processor and a second high speed I/O bus? 
the UNIBUS. This UNIBUS is an 18-bit pathway permitting transfer 
of either 18“-bit words, 16-bit PDP-11 words,- or two 8-bit bytes. 


The UC15 allows flexible low cost configuration and expansion 
of PDP-15 systems. 

The UC15 minimizes the peripheral processing load on the PDP™ 
allowing maximum computational throughput in a low-priced, 
medium scale system. 



FIGURE 1 ; Simplified UC15 Diagram 


UNICHANNEL 15 OPERATION 

There are three major components of the UC15: 

1. A PDP-11/05 computer with !S local 18 PDP-11 memory. 

2. An MX15-B memory multiplexer which allows both the PDB-15 
processor and the PDP-11 processor to share common memory 
The shared memory is ordinary 18-bit PDP-15 core memory. 

















Figure 2i 


Diagram of UC15 Hardware Interred 















SUMMARY - UNICHANNEL 15 HARDWARE ARCHITECTURE 


This particular architecture was chosen.because of its many advan¬ 
tages® . . . . • a 

PDF™15 Memory is. addressable by the UNIBUS® Hence, DMA transfers 
from and to such secondary storage devices as disks are direct® 

The interrupt link provides inter-processor signaling on a micro- 
second basis® This is ideal for efficient real-time service — 
a necessity for flexible I/O control® 

All PDP-15 systems may be upgraded by adding the UC15® All memory 
remains useable® 

Cost is minimized by allowing the PDP-11 to share the PDP-115 console 
and paper tape loader system® 

Maximum use of the PDP-15 memory is maintained through synchroniza¬ 
tion overlap with memory use by the MX15-B. This H pre set up" tech¬ 
nique increases the number of memory cycles per second when both 
PDP-15 and PDP-11/05 are accessing the common PDP-15 memory® 

The UNIBUS provided by the UC15 is electrically compatible with any 
device meeting UNIBUS interfacing specifications with the following 
restraints; 

1® UNIBUS lengths must be kept short® 

2® No provision is made for UNIBUS parity® 

Data in the common PDP-15 memory may be treated as either 18 or 16 
bit words or as (2) 8-bit bytes® 

True simultaneous parallel processing is possible in the local and 
common memories® 

The DMA rate is high and the worst case and average latencies are 
low for maximum I/O performance® 

Finally^ the system is highly modular allowing flexibility in con¬ 
figuration and excellent software utilization and control® The 
system permits variations in both local and common memory size® It 
allows almost any combination of PDP-15 and UNIBUS peripherals® 







UNICHANNEL “15 SOFTWARE ARCHITECTURE 


The hardware architecture is complimented by sophisticated system 
software. PDP-15 software systems running with a UNICHANNEL 
system relies on PIREX^ a compact multitasking peripheral executive. 
In addition to PIREX* Digital supplies UNIBUS device drivers, 
UNICHANNEL compalible handlers, and supporting utility functions. 

The software system used by UC15 consists of two parts: 

1. One component is a mutli-programming peripheral processor 
executive called PIREX and is executed by the PDP-11. 

2. The other component is an operating system in a PDP-15. 

(e.g. DOS-15 or BOSS-15) . 


PIREX 


PIREX is a multi-programming executive designed to accept any num¬ 
ber of requests from a PDP-15 or PDP-11 and process them on a prior¬ 
ity basis while processing other tasks concurrently. PIREX ser¬ 
vices all Input/Output requests from the 15 in parallel on a con¬ 
trolled priority basis. Requests to busy routines (called tasks) 
are automatically queued (entered into a waiting list) and processed 
whenever the task in reference is free. In a background environ¬ 
ment, PIREX is also capable of supporting any number of priority 
driven software tasks initiated by the 15 or the 11 itself. 

Figure 3 shows the communications flow in a UNICHANNEL system. 

The possible links which may exist in the system are as follows. 

1. Handler to driver to allow the PDP-15 to use a UNICHANNEL 
device. 

2. Handler to non-driver task to allow the PDP-11 to intercept 
output and manipulate it or store it for spooling. 

3. Program to non-driver task to allow cooperative processing 
on the two CPU 5 s as occurs in the use of the MAC-11 assem¬ 
bler o 




Figure 3 


DIAGRAM OF UNICHANNEL SOFTWARE SYSTEM 
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MEMORY LAYOUT 


Figure 4 details the memory map which exists on UNICHANNEL System, 
Note that both the 11 and 15 parts of the system can operate con¬ 
currently , all memory contention is resolved by the MX15-B* Note 
also*, that if the 11 system operates with area "A” complete simul- 
tinaiety is possible because no memory contention can occur. 




Available to PDP-15 
and PDP-15 I/O BUS 


J 


"Local" PDP-11 Memory = A 

"Shared" Memory = B 

PDP-11 CPU Address Space = A + B 

UNIBUS DMA Address Space = A + B + C 

PDP-15 Address Space = B + C + D 


Figure 4 : UNICHANNEL SYSTEM MEMORY MAP 




PIREX TASKS 


The PIREX software system consists of several routines to support 
multi-programming among tasks. These routines perform such func¬ 
tions as: context switching^ node manipulation and scheduling. 

The tasks which execute in this environment are device drivers*? 
directives to PIREX, or merely software routines which execute in 
a background mode* 

Device drivers are tasks which typically perform rudimentary device 
functions (e»g»: read*, write, search , process interrupts, etc *) , 
Directives are tasks which perform some specific operation for a 
task under PIREX * The connecting and disconnecting tasks to/from 
PIREX are performed by the CONNECT and DISCONNECT directives* The 
third type of tasks are software routines which execute in a back¬ 
ground mode of operation* The MACRO-11 assembler and Spooler are 
both run as background tasks* 

To support multiprogramming among tasks*, each task is required to 
have a format as shown in the figure below: 


Task Stack Area 


Control Register 


Busy/Idie Switch 





The execution of a Task by PIREX is accomplished by first scanning the 
Active Task List (ATL). The ATL is a priority-ordered linked list ot all 
active Tasks in the current system currently capable of running. An 
Active Task is one whichs 

1. Is currently executing. 

2 e Has a new request pending in its deque (double ended queue). 

3. Has been interrupted by a higher priority task. 

When a runnable task is found, the stack area and trans¬ 

registers belonging to the task are restored and program control tran 

ferred to it. Program execution begins at the where the task was 

task program code (See Figure 2.1) or at the point where the task was 

previously interrupted by a higher priority task. When a task is in 
terrupted by other tasks, its general purpose registers an * s t a °* * r ® r 
saved. The ATL is rescanned when a new request is issued 
when a previous request is complete. 

When the PIREX Software System is running, it is normally the 

NUL task (a PDP-11 WAIT Instruction); The NUL task is run whenev 
are no requests pending, a task suspends itself in a wait state, 
or while all other tasks are waiting for I/O previously initiated. 

When the PDP-15 issues a request to the PDP-11 to be carried out by 
PIREX, it does so by interrupting the 11 at Level 7 (the high 
PDP-11 Interrupt Level) and simultaneously passing it an addre 
of a Task Control Block (TCB) through the interrupt Link. 

An 11 task can issue requests via the IREQ MACRO. 

The contents of the TCB completely describe the request (task a 
ressed, function, optional interrupt return address.vi pnp-15 
status words, etc....) The TCB will usualiy reside in the PDP 15 
memory and must be directly addressable by the 11. (i.e. It 

in shared memory). 

Error conditions are passed back to _ the 15 ^Lessar^for 
trol Block (TCB) along with status ytormation neces y 
complete control and monitoring of a particular req 
Usually the request is to a device on the 11 but other types 

are allowed. 


Task Control Blocks are used for communication withPIREX and 
tasks running under it. The general format of a TCB 
three words followed by optional words necessary for task commun 
ication. Optional words, generally are used to pass buffer add 
resses, commands and device status as may be appropriate. 


TCB 


(API TRAP ADDRESS *400(8)) + API LEVEL 
(FUNCTION CODE *400(8)) + TASK CODE NUMBER 


REVi REQUEST EVENT VARIABLE 
(Optional Words) 

Figure 6 STANDARD TCB FORMAT 



The "TRAP ADDRESS" is a PDP-15 API trap vector and has a value 
between 0 and 377 /g\■ Location 0 -here corresponds to location 
0 in the PDP-15® The API Level is the priority level at which 
the interrupt will occur in the PDP-15 and has a value between 
0 and 3® A 0 signifies API "Level 51 0 * a 1 for level 1 etc... 
The API trap address and level are used by tasks in the PDP-11 
when informing the 15 that the requested operation is complete 
(e.g...a disk block transferred or line printed). 

The Task code number is a positive number between 0 and 128 
that tells PIREX which task is being referenced* (Tasks are 
addressed by a numeric value rather than by name)« 


The Function Code determining whether hardware interrupts are 
to be used at the completion of the request® If the code has a 
value of 0 S an interrupt is generated at completion of the request 
If a 1* an interrupt is not made® 


The Request Event Variable* commonly called REV or just EV* is 
initially cleared by PIREX (set to zero) and then set to a value 
(by the associated task) at the completion of the request® The 
values of "n" ares 


0 = request pending or not yet completed® 

1 = request successfully completed® 

2 = (mod 2•16-1) non-existent task referenced® 


-3 = (mod 2°16-1) illegal API level given (illegal 

values are changed to level 3 and. processed) . 

-4 = (mod 2016 - 1 ) illegal directive code given. 

-777 = (mod 2°16-1) request node was not available from 

the Pool* i.e. the POOL was empty* and the referenced 
task was currently busy or the task did not have an 
ATL node in the Active Task List® 


NOTE — the Task Control Block specification clearly defines a 
modular communications structure with minimum impact on PDP-15 
software® 



ADDING DRIVERS TG PIREX 


A powerful feature allows the PDP-15 to bring in a PDP-11 driver, 
(into either its own memory or the 11 8 s ^ local memory) connect 
it to PIREX via a connect directive (a disconnect directive) is 
also provided) and then issue I/O requests through PIREX to the 
driver» The user can now take full advantage of the existing and 
future PDP-11 peripherals along with an elaborate queuing struc¬ 
ture built into PIREX allowing complete parallel processing. 


MACRO 11 ASSEMBLER (MAC11) AVAILABLE) 

A MACRO 11 Assembler is provided. This assembler is a Macro sub¬ 
set of the existing PDP-11 Macro assembler and is slightly modif¬ 
ied to run under the control of DOS-15 and PIREX. 

To accomplish this, the MACRO assembler (MAC11) is loaded by the 
15 as a core image into bank 1 of the 15. MAC 11 is then^connected 
up as a low priority driver to PIREX and requested to begin the ass¬ 
embly. The 11 then carries out the actual assembly while the 15 
handles all of the opening and closing of files, reading and writ¬ 
ing of test and object information until the assembly is complete. 

To the user at the console teletype, MAC 11 appears to be just a 
DOS-15 system program which is loaded in and run by the 15. 


NOTE s That any customer developed 
Into account PIREX context switch, 
and latency consideration of the as 


software should of course, take 
the bandwidth of the UNIBUS 18 

sociated system. 


SUMMARY 


As one can easily see, the UC15 software system is a powerful tool 
to the user who requires the utmost in flexibility and utility. 
UC15 also provides an expansion capability beyond any system cur 
rently available. 



INTERRUPT LINK 


The following section describes the registers and control of the 
interrupt link. This link is used to pass Task Control Block 
Pointers (and through them the information in Task Control Blocks) 
between the PDP-15 and PDP-11 systems. The hardware which com¬ 
prises this link consists of a DR15-C special purpose interface 
to the PDP-15, I/O BUS, and 2 DR11-C general purpose UNIBUS inter- 
faces• The DR15-C is controlled by PDP-15 IOT § s while the DR11* s 
are accessed as registers on the UNIBUS. 

Register Descriptions (PDP-11) 


(CSR) 767770 Bit 6 - when bit 6 is a 1, it will enable an inter¬ 
rupt on BR5 to TV 300, if the API DONE flag is set 
in bit 7 of 767770. 



















Bit 8 - Local Memory Size bit 0 - the least signif 
leant bit of a two bit field which specifies the 
number of - 4K word memory banks that are connected 
to the UNIBUS. 


Bit 9 - Local Memory Size Bit 1 - the most signif¬ 
icant bit of a two bit field which specifies that 
number of 4K memory banks are connected to the 
UNIBUS. 


0 0 0 Local Memory 

0 1 4K Local Memory 

1 0 8K Local Memory 

1 1 12K Local Memory 

Bit 14 - API 3 DOME flag - when a 1 indicates that 
their© is no API level 3 request pending before the 
PDP-15 » When a 1 also indicates that 767762 high 
byte may be located with s new API level X address 
to cause a new API interrupt at level 3 and set the 
API 3 flag in the DR15-C. 

Bit 15 - API 1 DONE flag - when a 1 indicates that 
there is no API level request pending before the 
PDP-15. When a 1 also indicates that 767772 high 
byte may be loaded with a new AP± level 1 address 
to cause a new API interrupt at level 3. and. set the 
API in the DR15-C, 


(GSR) 767760 Bit 6 - ENABLE TCBP (Task Control Block Pointer) 
INTERRUPT - When a 1 allows and interrupt on BR 
level 7 to TV 310 upon receipt of a new TCBP from 
the PDP-15 a 

Bit 7 - NEW TCBP flag - is set to 1 whenever the 
PDP-15 issues XOT 706006 thus placing a new TCBP 
in 767764 and bits 0 and 1 of 767774. It is cleared 
by the PDP-11 doing a DATI to location 767764. 

(ODB) 767762 Low byte - contains the API address for an API level 
2 break. Same conditions as 767772 low byte. 

High byte — contains the API Address for an API level 
*3 @ conditions as 767772. 




(IDB) 767764 


PDP-15 IQT 8 s 
706001 

706002 

706006 


706112 

706122 

706104 

706124 

706144 

706164 

706101 


TCBP (Task Control Block Pointer) - bits 3-17• 

This contains the lowest 15 bits of the address sent 
by the PDP-15. Notes that the address is "word" 
aligned• Note also that doing a DAT! to this reg¬ 
ister lowers the New TCBP flag (767760 bit 7) 
and also sets the DONE flag cleared by IOT 706002 
in the PDP-15 „ 


SIOA - Skip I/O Accepted. Tests whether the TCBP 
DONE flag is set indicating the PDP-11 has read 
the TCBP and skips the next location if the DONE 
flag is a 1. 

CIOD - Clear I/O Done. Clear the TCBP DONE flag. 

LIOR - Load I/O Register and clear TCBP DONE flag. 
Places the contents of the PDP-15 "AC" into an 18- 
bit buffer register. The output of the buffer 
register is seen by the PDP-11 as TCBP at location 
767764 and bits 0 and 1 767764. The IOT also 
causes the TCBP DONE flag to be cleared and in the 
PDP-11 causes bit 7 to be set in location 767760* 
which in turn causes the PDP-11 to do an interrupt 
at BR 7 to TV location 310. 


RDRS - Read Status Register - Clears the AC and 
loads the contents of the DR15-C status register 
into the AC. (This effectively moves the DR15-C 
enable interrupt bit into bit 17 of the AC). 


LDRS - Load Status Register. Loads the contents of 
the AC into the DR15-C status register. (Places 


value 
bit) . 

of AB bit 17 

in the DR15-C "< 

CAP 10 

- Clear 

APIO 

flag 

in 

DR15-C o 

CAP 11 

- Clear 

API! 

flag 

in 

DR15-C« 

CAP X 2 

- Clear 

API 2 

flag 

in 

DR15-C. 

CAP 13 

- Clear 

API 3 

flag 

in 

DR15-C. 

SAP 10 

- Tests 

the AP10 

flag in the 


the next instruction if the flag is 1 







addre 

76777 



























If both processors request at the same time, PDP-15 will get use 
of the memory. When requests are not simultaneous, a first come, 
first served mode, operates * Practically, all this means is that 
the 15 and 11 will alternate access to common memory except under 
the special conditions described above® NOTE? No local memory 
is provided on the PDP-15. 

Bus Loadings MX15-B. . . . . . . . . . 2 PDP-15 memory bus load 

Drives 4 PDP-15 memory bus loads 

DR15-C/DR11-C . . • 1 Unibus Load 

1 PDP-15 I/O bus load 

Powers(Steady State) 

UNICHANNEL 15 (no peripherals). .5 at 115V 

2.5A at 230V 

Voltage s 115 Vac 1 10% or 230 Vac t 10% 

Frequency s 50 — 2 Hz or 60 + 2 Hz 


Environmentals Temperature. .......10° to 50°C 

Relative Humidity.......20% to 95% 

UC15 Cabinet Dimensions s Depth:....30in (0.76m) 

Widths seso 21 in. (0.53m) 

Height i . ..72 in® (1.83m) 

Weights ...150 lbs. (70 kg)-not in¬ 
cluding peripherals. 

Unibus Compatabilitys Can be used with any PDP-11 family pro¬ 
cessor that does not use parity. On 
those systems with parity, the parity 
must be disabled. 

Memory Cycles MX15-B normally adds 200 ns to both the PDP-15 
.. and the PDP-11 cycle times. 

DMA Facility to Common Memorys 

Maximum transfer rate•••.•415K words/sec 
Worst-case latency........6 /is (no DCH transfers 

in PDP-15) 

12 /is (DCH transfers 
in PDP-15) 

Average latency........... 2.5 /is 

DMA Facility to PDP-11/05 Local Memory : 

Maximum Transfer rate.1 million words/sec 

Worst-case latency........7.2 /is 

Average latency...........2.5 /is 



PDP-11/05 with 
8-12K of local memory 
2 small peripheral 
slots and 3 system 
unit slots 


Reserved for 
BAll peripheral 
expander box 





























SYSTEM RESTRICTIONS 


RK05 (RK11) Disk Pack Capability 

The 18 bit RK11 disk pack will not be able to be read by RK11-C 
or RK1X-D system (16-bit only systems). 

This means that data bases and PDP-11 files created on 18-bit 
RKli systems may not be taken directly to an PDP-11 only sys- 

teiru The transfer medium for such a transfer would have to be 
Mag Tape* 

This situation was chosen to make RK11-C and RK11-D packs com¬ 
patible (i»e* oess all PDP-11 only systems)* 


Memory Limits 

«aaar«*aanmimi7fflflazEiiTTHiTinnCTTix£^&som*ma»g— - 

UNIBUS NPR devices can access a maximum of 124K* The amount of 
shared memory available to UNIBUS NPR devices is X24K less the 
amount of local memory* In a "normal 58 configuration the PDP-11/05 
would have 8K of memory , in which case the available PDP-15 mem¬ 
ory would be limited to 116K* This limit is due to the fact that 
UNIBUS/18 peripherals must have access to all memory* The max¬ 
imum memory of the 11 without some relocation option would be 28K* 


Notes That the PDP-11 with 8K of local memory can only address 
the lowest 2OK of common memory to access Task Control Blocks 
set up by the PDP-15* 

I/O Latency 

Multiport memories always have increased worst case latency 
over a single port-non-competitive situation* This system 
is no exception* The PDP-11 normally gives an "NPR break" 
a worst case latency to BSSY of 7*0 usee* On this system, we 
must add to that time? the time it requires the PDP-15 to do 
three I/O memory cycles (5*0 usec e ), The worst case latency 
is , hence? 12»0 usee* 

CAF/RESET Limitations 

The following timing considerations are of interest to pro¬ 
grammers : 

A RESET instruction may cause the PDP-15 to incorrectly read 
the API address* The Console RESET and CAF instruction may 
violate UNIBUS specifications* Hence? random "initialize" 
pulses may cause system malfunctions* The following guide¬ 
lines must always be followeds 




CAF must not be executed while there is © Task. Control Block 
Pointer (TCBP) waiting to be read by the PDP-11* 

RESET must not be executed whil© there are API requests 
pending for the PDP-15. 

RESET must not be executed if there is any NPR activity on 
the UNIBUS. All active NPR devices must be shut down in 
a power fail sequence prior to executing RESET. 





PDP-15 UNICHANNEL OPTIONS 



UC15“HE Peripheral Processors 11/05 or 11/I0-NC 8K Local Memory 

or - SA, 2 DR11-C, DR15“C, MX15-B, DD11-B, 

KY11-JH, H950, 115V.- 



UCIS^HK Peripheral Processors 11/05 or 11/10 - NC 12K Local Memory 

or - SA, 2 DR11-C, DRIS^C, MX15-B, DD11-B, 

KY11-JH, H950, MM11-K, 115V. 

UC15-“HL Peripheral Processors 11/05 or 11/10-ND 12K Local Memor] 

or - SA , 2 DRll-C , DR15-C, MX15-B, DDll-B, 



KY11-JH, 

H950 

, MM11-K 

, 230V e 


RK15-HE 

RK05-AA, 

RK11 

-E s 

UC15- 

-HE „ 

115V, 

60Hz 

RK15-HF 

RK05-BB, 

RK11- 

-E , 

UC15- 

-HF , 

23 0V, 

50Hz 

RK15-HH 

RK05-AB s 

RK11- 


UC15- 

-HF , 

230V, 

60Hz 

RK15-H.J 

RK05"“BA s 

RK11- 

”E e 

UC15- 

“HE s 

115V, 

50Hz 

RK15-HK 

RK05-AA, 

RK11 

“"El $ 

UC15- 

~HK s 

115V, 

60Hz 

RK15-HL 

RK05-BB, 

RK11 

“E / 

UC15 

“HL s 

23 0V, 

5 GHz 



T 

15/76-DF 

KP15, 
TCI5, 

ME15-EB, LA30““CD, PC15-A, KE15 
TU56 , RK15-HF, 230V, 50Hz. 

s KW15 , 


15/76-DK 

KP15, 
TCI5, 

ME15-EA, LA30-CA, PCI5, KE15, 
TU56, RK15-HK, 115V, 60Hz. 

KW15, 


15/76“DL 

KP15, 
TCI 5, 

ME15-EB, LA30-CD, PCI5-A, KE15 
TU56, RK15-HL, 230V, 50Hz o 

, KW15, 


15/7 6-ME 

KP15, 
. TC59- 

MEIS-EA, LA30-CA, PCI5, KE15, 

D , TUI0, RK15-HE, 115V, 60Hz„ 

KWl 5 r 
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INTRODUCTION 

The Magnetic Tape Dump (MTDUMP) Program is a utility program of the 
PDP-15 ADVANCED Software System which provides users of industry- 
compatible magnetic tape with functions which are peculiar to this 
medium. In general, the program provides magnetic tape users with 
functions similar to those found in PATCH and DUMP. In addition, 
the program complements PIP with regard to magnetic tape functions; 
however, few functions which could be performed by PIP are duplicated 

The program MTDUMP is device dependent and accomplishes all magnetic 
tape I/O with .TRAN and MTAPE System Macro instructions; it cannot 
be used with other I/O devices. 

1.1 FUNCTIONS 

The following paragraphs briefly explain the basic functions of 
MTDUMP. A summary of commands is provided in Appendix A. 

1.1.1 Dump File 

One of the most common requirements of the magnetic tape user is the 
ability to examine portions of a tape. The Dump File facility in 
MTDUMP is intended to meet that need in a general and useful way. 
Simply stated, the Dump File is the repository of (1) images of com¬ 
mand lines received from the keyboard and (2) groups of ASCII lines 
which represent, in readable form, the contents of the tape being 
examined in response to typed requests. The contents and format of 
the file, however, are subject to considerable variation and, in fact 
the destination of the file may itself be changed during the run. 

1.1.2 File Modification 

This feature provides a convenient means for file updating or patch¬ 
ing. Individual records may be accessed, allowing each word in the 
record to become available for examination and modification. Words 
and entire records may be inserted or deleted from the file and new 
files may thus be created. 

1.1.3 File Transfer 

This function, consisting of one instruction, permits copying 
magnetic tape on a record-for-record basis. 


181 





1.1.4 Directory Listing 

These commands permit rapid listing and clearing of magnetic tape 
directories. 

1.2 I/O DEVICES 

The program accesses a maximum of three devices: the teleprinter, 
used for command string input and error reports; the magnetic tape 
transports (via MTA. or MTF.) for all input and output to all magnetic 
tape units; and an optional third device which is the destination 
device for what is termed the "Dump Output File". This file may con¬ 
tain records of commands typed to the program and any hard-copy 
response to these commands (normally record-by-record dumps). Dump 
Output may be directed to any device, including a magnetic tape. If 
magnetic tape is used for this purpose, however, the unit assigned may 
not also be manipulated by commands to MTDUMP. If no Dump Output file 
is desired, the teleprinter should be assigned as the Dump Output 
device. 

1.3 ADDING MTDUMP TO THE USER SYSTEM 

The program MTDUMP and its associated handlers (i.e., MTA, MTC, and 
MTF) are supplied to the user on the ADVANCED Monitor System Peripheral 
DECtape (DEC-15-SZZB-UC) . Users who wish more convenient access to 
MTDUMP should relocate the program onto the system device using the 
utility program PIP. 


MTDUMP may also be added to the system device as a System Program, 
using the facilities provided by the SGEN and PATCH utility programs. 
Refer to PDP-15 manuals DEC-15-YWZA-DN3 and -DN5 for the procedures 
needed to install MTDUMP onto the system device as a System Program. 

If MTDUMP is relocated to the system device by either of the above 
means, its associated magnetic tape handlers must also be added to 
the system library (.LIBR BIN). This is accomplished using the util¬ 
ity program UPDATE. The use of UPDATE to insert the handlers MTA, 
MTC, and MTF is demonstrated in the following example: 
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UPDATE V8A 


>US+- (ALT MODE) 
>1 MTA. ,DTC * J 
>T MTC 
>IMTF 
>CLOSE ) 


Request Options U and S 

Insert routine MTA after routine DTE 

Insert routine MTC next 

Insert routine MTF next 

Terminate UPDATE operations. 


Refer to the Utility Programs manual DEC-15-YWZA--D for a complete 
description of UPDATE and its use. 





CHAPTER 2 


OPERATING PROCEDURE 


2• 1 DEVICE ASSIGNMENTS 

MTDUMP is supplied as a relocatable program (MTDUMP BIN) and is 
loaded by the Linking Loader. Before loading? the user must make 
the following .DAT slot assignments: 


.DAT slot -4 


.DAT slot 1 
.DAT slot 3 


The device from which MTDUMP is to be 
loaded. If the program is on magnetic 
tape, MTA on .DAT slot 1 requires MTA 
on .DAT slot ~4; MTF on .DAT slot 1 
requires MTC on .DAT slot -4. 

MTA/ or MTF/ 

The Dump Output device, if required; 
or TTA if no Dump Output File is wanted. 


2.2 PROGRAM STARTUP 

After loading, the program types on the teleprinter: 


MTDUMP Vnn where: u Vnn" is the current version 

BUFSIZ m and "m" is the total number 

> (in decimal) of registers 

available for I/O buffers. 

Each time the program is ready to accept a keyboard command, a right 
angle bracket (>) is typed. 


At start (or restart) time, all magnetic tape units are automatically 
set to transfer in odd parity at 8 00 BPI and at the channel count 
given by .SCOM+4, bit 6 (0 means 7-channel, 1 means 9-channel). The 

user must issue a new FORMAT request (see paragraph 3.2.1) to effect 
transfer in another (non-standard) mode. 


2 * 3 PROGRAM RESTART 

To restart MTDUMP, type CTRL P, which causes the program to close the 
Dump Output File (if open) on .DAT slot 3. Then repeat program 
startup procedure. 


NOTE 

If the Dump Output has been directed to the 
teleprinter, CTRL P is acted upon only after 
completion of current line of output. To 
effect immediate termination, type CTRL P 
CTRL U. 
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COMMANDS 


3.1 COMMAND STRING 

MTDUMP accepts commands from the Teletype in the general format shown 
below. Formats for specific commands may vary significantly from this 
and are shown in the descriptions of the individual commands. 


MTDUMP command formats are variations of the following; 









where; 

c is the name of the function wanted. 

u, is a digit specifying the source unit for two-unit 
1 operations (e.g., COPY) or the one object unit for 
single-unit operations. 

u„ is a digit specifying the destination unit for two- 
1 unit operations or is absent for single-unit 
operations. 

t specifies a condition (either count overflow or 
transport status) which, when encountered, 
causes termination of the function whose name is 
"c". "t" may be absent and, if not given, is 

assigned the implicit integer value 1. Explicit 
values of "t" may include; 

a. An integer in absolute value less than 262,144^^ 
and greater than zero 

b. The character string "EOT" (END OF TAPE) 

c. The character string "BOT" (BEGINNING OF TAPE) 

d. The character string "EOF"(END OF FILE) 


Parameters are separated from the command by a space (u) and from each 
other by commas. The command line is terminated by a carriage return 

0 >- 

Some commands require only a single argument, while others require all 
three. 


Example: 

REWIND^! J 

Only the single object unit need be specified; further, the terminating 




condition "BOT" is implicit in the command and need not be given. 
Copying an entire logical tape from Unit 1 to Unit 2, however, re¬ 
quires all three parameters. 

Example: 

C0PYi_il,2,E0T % 


3.1.1 Terminating Conditions 

As indicated above, the "t" specification in the command line may be 
either an integer or a character string or absent. If "t" is an 
integer, the value of the numeric string represents the number of 
physical records to be treated during the operation requested. 

Example: 

SPACE l_j1, 80j 

This command string means: Evaluate the string "80" according to 
the radix currently in effect, then space the tape on drive 1 forward 
until that many records have been passed over. If, in the example, 
tape 1 was at loadpoint and if the prevailing radix was decimal, then 
at the completion of the operation the read/write head would be 
positioned between the 80th and 81st physical records on tape. 

Example: 

COPYul, 2,80j 

The above example causes a transfer of 80 physical records from drive 1 
to drive 2, leaving the read/write head on each drive positioned 
immediately following the last record transferred. 

If "t" is a non-numeric string (EOT, BOT, EOF), then the operation re¬ 
quested is deemed complete when one of the following conditions is 
observed: 


a. 

EOT 

Two consecutive EOF markers have been passed 
in either reverse or forward direction. 

b. 

BOT 

The loadpoint marker has been reached (but not 
passed) in the reverse direction. 

C 3 

EOF 

A single EOF marker has been passed in either 
direction. 


If "t" is the string "EOF" or "EOT", the position of the read/write 
head relative to the EOF marker causing termination depends upon 
the direction of tape motion when the condition is encountered. 




Example: 


BACKSPACEujl,EOF j 

The read/write head will be positioned just before the marker. The 
next record read in the forward direction will be the EOF marker 
just passed in backspacing. 

If "t" is the string "BOT", the head is left positioned just after 
the loadpoint; the program will not backspace over BOT. 

If "t" is absent from a command string in which it is required, then 
the value 1 is assumed. Thus the commands in the following example 
are equivalent. 

Example: 

SPACE i_il,l) 

SPACE i__il^ 

3.1.2 Command Abbreviations 

Most commands in MTDUMP may be abbreviated to a single letter (the 
initial character). In the command descriptions which follow, legal 
abbreviations are shown immediately following the command and enclosed 
in parentheses. 

Example: 

REWIND (R) uu, t^ 

3.2 SETUP COMMANDS 

This is a group of commands which generally apply to most major func¬ 
tions of MTDUMP. These commands are usually given prior to the execu¬ 
tion of a function (e.g., DUMP, COPY). 

3.2.1 Set Non-Standard Tape Format 

The initial setup for input and output tapes is odd parity at 
800 BPI (the channel count is given by .SCOM+4, bit 6). The 
FORMAT command allows the user to change the parity, density, 
and/or channel count. 


Usage: 


FORMAT (F) i«^u,pdc^ 



where: "u" is the tape whose format is being set and "pdc" is a 

group of three single-character parity, density, and channel-count 
indicators, as follows: 

p (parity) is "E" (even) or "0" (odd) 
d (density) is "2" (200 BPI), "5" (556 BPI), or 
"8" (800 BPI) 

c (channel) is "9" (9-channel) or "7" (7-channel) 

The three descriptors may appear in any order, and any may be absent, 
in which case the relevant status for the tape remains unchanged. 

Example: 

FORMAT^2, E57J 
or 

FORMAT5_j2,5E7^ 
or 

FORMAT i_»2,7 5E j 

All of the above examples set up tape unit 2 for even parity, 556 BPI, 
7-channel operation. 

Example: 

FORMAT &«j2 , Oj 
or 

F i_j2 , O^ 

These commands change the parity of tape unit 2 without disturbing 
the current density or channel count. 

NOTE 

The only legal density for a 9-channel tape drive is 
800 BPI. Requests for other densities will not be 
honored. 

FORMAT commands are effective until MTDUMP is restarted via the 
CTRL P function. 

3.2.2 Set Standard Tape Format 

Standard System Format may be requested for any unit. A special case 
of the FORMAT command is employed to unconditionally reset tape format 
to odd parity, 800 BPI, and 7- or 9-channel (according to .SCOM+4, bit 6.) 
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Usage: 







FORMAT (F) uU,D^ 

where: "u" is the unit whose format is to be set and the character 

"D" means "default'.' 

3.2.3 Specify Global Radix 

The program always treats certain numeric strings (e.g., unit specifica¬ 
tion) as octal. Others, however, may be specified as either octal or 
decimal by the NUMBER command. The following numeric groups are 
interpreted (on input) or printed as octal or decimal strings according 
to the argument given in the latest NUMBER request: 


a. The "t" specification in command lines (where applicable) 
when "t" is an integer. If the current radix is octal, 
then the command: 

SPACE «-jl,20j 

causes the tape on unit 1 to be spaced forward 16., n 
records. 

b. The word sequence numbers of dumped data. 

c. The word sequence numbers of EXAMINE requests. (See 

below.) 

d. The record-length argument of the SIZE request. (See 
below.) 


The radix specified remains in effect until another NUMBER command is 
encountered or the program is restarted. The default radix is octal. 


Usage: 


NUMBER (N) B_J 


foCTAL "X 
^DECIMAL )) 


3.2.4 Specify Local Radix 

The radix of a number string in a single command line may be specified 
by a one-character suffix, D for decimal, K for octal. Such specifica¬ 
tion overrides the current global radix, but is in effect only during 
the processing of the command line in which the suffix appears. Local 
radix control may be used following: 


a. The "t" specification in command lines (where applicable) 
when "t" is an integer. 

b. The word sequence numbers of EXAMINE requests. 





The record-length argument of the SIZE request. 


c. 


Example: 

SPACE ul , 2 j2fD^ 

The command above causes tape unit 1 to space forward 2 0 10 records 
regardless of the current global radix. 

Example: 

SPACEul, 2)2lK^ 

Similarly, this command spaces the tape forward 20g (16 -^q) records. 

3.2.5 Command-Line Echo 

Legal keyboard requests are placed in the Dump Output File, exactly 
as typed, to allow the user to correlate the progress of the run, 
relative tape position, and the record contents during later examina¬ 
tion of the hard-copy dump. Command-line echo can be bypassed, how¬ 
ever, by use of the VERIFY command. 

Usage: 

VERIFY (V)^}; 

If ON or OFF is not specified, ON is assumed. 

Example: 

When MTDUMP is first loaded or is restarted, VERIFY mode is set ON. 

If the teleprinter is the assigned dump output device (.DAT slot 3), 
command-line echo is not performed. Illegal commands are not echoed. 

3.2.6 Dump File Display Format 

The input tape is output to the Dump File as individual physical 
records. Each record is represented as a number which indicates 
record length in ASCII lines. Each line, in turn, contains: 

1. A sequence number which reflects the position in the 
record of the first data word in the line displayed. 

2. A string of data words or data-word pairs. 

Sequence numbers are in either octal or decimal notation; the radix 
is chosen in response to the last previous NUMBER command. 



Display format is set by the MODE request followed by the appropriate 
argument. 


Usage: 


MODE t-J 


[octal 1 
ISYMBOLIcl 
\TRIMMED f 
ASCII 


Where: 

OCTAL 

SYMBOLIC 


TRIMMED 

ASCII 


Displays single words as six octal digits. 

Displays single words as a three-character 
operation-code mnemonic, an "indirection" 
indicator (*), if present, and a 13-bit 
(5-digit) address. 

Displays single words as three six-bit 
alphanumeric characters. 

Displays pairs of words as five seven-bit 
ASCII characters. A blank is printed for 
each character outside the range 40 g - 137 g . 


The default assumption is OCTAL and implicit in the request: 


MODEj 

The table below shows examples of data-word treatment in each of the 
four modes. 


OCTAL 

SYMBOLIC 

TRIMMED 

ASCII 

512132 

AND 12132 

)QZ 

REWIN 

744634 

OPR 04634 

<&\ 


420320 

XCT*00320 

#CP 

D 

000000 

CAL 00000 

@@@ 


777777 

LAW 17777 

??? 

A 

010203 

CAL 10203 

ABC 


Inserting 

Comments in the 

Dump File 



Explanatory notes may be placed in the output file by use of the LOG 
command. When the LOG request is encountered, subsequent typed input 
is taken as commentary and is added, exactly as it appears, to the 
Dump Output File. Carriage returns may be included, and multiple 
lines may be inserted with a single LOG request. An ALTMODE terminates 
each comment and causes the program to accept a new request. 



Usage: 

LOGucomments 1 

comments. . 

(ALTMODE) J 

3.2.8 Return Control to Monitor 

An EXIT request causes the program to close the Dump Output File 
(if one is open) on * DAT slot 3, then perform an .EXIT return to 
the Monitor. Use this command for return to the Monitor if the 
program is being run in the Batch Environment. 


Usage: 

EXITj 

3.3 MANIPULATIVE FUNCTIONS 

The following commands position the tape and write EOF markers 
on the tape drive specified. 

3.3.1 Rewind Tape 

This command initiates a rewind on tape unit "u ". 

Usage: 

REWIND (R)i-juj 

3.3.2 Backspace Tape 

This command backspaces the tape on unit "u" until the "t condition 

is satisfied. 


Usage: 

BACKSPACE (B)t-jU, tj 

where: "t" is an integer (number of records), "EOF", "EOT", or 

"BOT". 

3.3.3 Space Tape 

This command spaces the tape on unit "u" forward until the t 
condition is satisfied. 

Usage: 


SPACE (S)uu,t .% 


where: 


t" is an integer (number of records), "EOF", or "EOT". 



3.3.4 Write End-of-File Marker 







This command writes a single "EOF" marker on tape unit "u". 

Usage: 

TAPEMARK (T) s__i u * 

J 

3.4 DUMP FILE OPERATIONS 
3.4.1 Dump File Management 

The Dump Output File may be written on any physical device. If the 
device chosen is file-structured, however, the user must specify a 
name to be given the Dump File and must explicitly request that the 
file be closed (unless the EXIT command is used). Furthermore,, the 
file name must be given before any other requests are issued. 

Usage: 

where: 

ext is the filename extension. If omitted, 

"LST" is the default assumption. 

If an OPEN request is not given, the program types 

NO DUMP FILE OPEN 
> 

on the Teletype and waits for another command. 


OPENu filename u^ext^ 

filename is the name of the file to be created. 


NOTE 

The comment is actually printed when an attempt is 
made to write into the Dump File, i.e., at command¬ 
line echo if VERIFY is ON or at Dump-Record Output 
if VERIFY is OFF. 


A check is made to ensure that the filename given is unique. If a' 
file of the name specified already exists on the Dump Output device, 
the program types: 


FILE FOUND ON DUMP DEVICE: 
DO YOU WISH TO DELETE IT? 

> 


filenam ext 



The program then waits for the user to type a response to the query. 
Typing 


or 



or 


YES j 


indicates the affirmative, and the already-existing file ie overlayed 
(i.e., deleted when the new file is .CLOSEd). Any other response is 
negative and the program returns to accept a new keyboard command. 

The Dump Output File is closed upon receipt of the CLOSE command 
from the keyboard. 

Usage : 


CLOSER 

or whenever the program is restarted (CTRL P). 

3.4.2 Dump Tape Records 

This command dumps records from unit "u" into the named file open on 
.DAT slot 3. The sequencing of data words and the format in which 
they are written are controlled by the latest NUMBER and MODE re¬ 
quests . 

Usage: 

DUMP (D)uU,tj 

where: "u" is the tape unit number 

"t" is an integer (number of records), "EOF", or "EOT". 

3.4.3 Dump Tape Records on the Telep rint er 

This command performs the same function as the DUMP command, except 
that the records are unconditionally dumped on the teleprinter. 

Usage: 

LIST (L) uU, t % 



3.4.4 Tape Status 

In addition to data input from magnetic tape and the Teletype, the 
Dump Output File contains indicators of status encountered on the 
tape being read. Comments are added to the file (and typed on the 
teleprinter) in response to the following observed conditions on the 


Meaning 


An unexpected end-of-file . 
marker was read. 

The end-of-tape reflective 
spot was reached on input 
or output. 

The tape record read is too 
long to be accommodated in 
the available buffer space. 

The loadpoint reflective 
spot was unexpectedly 
reached during a backspace 
operation. 


*PERMANENT READ ERROR ENCOUNTERED 

not been transferred correctly. 
The read/write head is 
positioned immediately before 
the record. 

3.4.5 Example of Dump Operation 

The following example shows the instructions required to dump the 
file directory of magnetic tape unit 0 in octal format (to allow the 
accessibility map to be examined) and then in trimmed ASCII format 
(to allow reading of the file name entries). 


After 64-„ read attempts, 
the input record still has 


Message 

*END OF FILE ENCOUNTERED 
*PHYSICAL EOT ENCOUNTERED 

*BUFFER OVERFLOW 

*BOT ENCOUNTERED 
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Examples: 


REWIND 0 
SPACE 0,1 
MODE OCTAL 


1 

747377 

000000 

747750 

777777 

750000 

000000 

000000 

000000 

000000 

10 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

131571 

19 

000000 

233123 

231320 

021413 

233123 

111702 

l4l300 

233123 

562331 

28 

231404 

233123 

5614H 

022200 

021116 

561417 

010400 

021116 

040424 

37 

710000 

021116 

031001 

111600 

021116 

302205 

060000 

021116 

050105 

46 

0 61114 

021116 

16 l7i6 

061114 

021116 

252004 

012405 

233123 

053005 

55 

032524 

233123 

0504ii 

240000 

233123 

201120 

000000 

233123 

066400 

64 

000000 

233123 

150103 

221700 

233123 

066401 

000000 

233123 

1 5 010 3 

73 

221701 

233123 

152423 

0705i6 

233123 

0 31 716 

260000 

233123 

152402 

82 

171724 

232203 

152404 

251520 

021116 

000000 

000000 

000000 

000000 

91 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

100 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

109 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

118 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

127 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

136 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

145 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

154 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

163 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

172 

000000 

000000 

000000 

000000 

000000 

0 0 0 0 00 

000000 

000000 

000000 

181 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

190 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

199 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

208 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

217 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

226 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

235 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

244 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

253 

000000 

000000 

000000 

000000 

000000 






BACKSPACE 0,1 
MODE TRIMMED 


hump a. 

1 















PPP 

1 

< ; ? 

PPP 

<? c 

111 

“ (3 (3 

@ @ @ 

P P (3 

@ @ @ 

@ @ @ 

@ @ (3) 

PPP 

@ @ @ 

PPP 

PPP 

©@<a 

17 

33 

PPP 

KM 9 

P p (3 

SYS 

SKP 

blk 

SYS 

1 ob 

L K 

SYS 

. SY 

SLD 

SYS 

.LI 

rR@> 

bin 

. LO 

A 0^ 

BI n 

COT 

g @ @ 

BIN 

cha 

I N@ 

BIN 

XRe 

p@@ 

bin 

EaE 

FIL 

bin 

non 

49 

F IL 

bin 

Upd 

aTE 

SYS 

E*F 

CUT 

SYS 

ED I 

T@@ 

SYS 

pip 

ppp 

SYS 

F4 @ 

ppp 

65 

SYS 

MAC 

R 0® 

SYS 

F 4 A 

(3 (3 (3 

SYS 

MAC 

ROa 

SYS 

mTS 

GEN 

SYS 

CON 

y@@ 

SYS 

81 

mtb 

OOT 

SRC 

mtd 

UMP 

BIN 

(3 p p 

P P P 

P P P 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

97 

p P P 

( 0 ) (3) (3 

(3 p (31 

P (31 (3 

(3 (3 p 

P {3 

P P P 

P P P 

P P P 

P P P 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

113 

p (3 p 

(3 @ @ 

(a) (3 (a) 

p (3 p 

PPP 

PPP 

p P p 

P P P 

P P P 

P P (3 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

129 

PPP 

@ (3 @ 

@@@ 

(3 (3 0 

P P (3 

(3 (3 (2) 

p P p 

P P P 

P P P 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

145 

PPP 

@@@ 

@ @ @ 

PPP 

P P P 

(3 p (3 

p P p 

P P P 

P P P 

ppp 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

161 

P (2) (3) 

@ (3 @ 

@ @ @ 

(3 (3 (3 

P P p 

PPP 

p P P 

P P P 

P P P 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

p p p 

177 

{31 (a) (a) 

(3(31(5) 

(3(3(3 

(3 (3 0 

(3 p (3 

P (3 (3 

p P P 

P p P 

PPP 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

193 

(a) (a) (a) 

(3(3(3 

@@{3 

(3 (3 p 

PPP 

P (3 p 

p p P 

P P P 

P P P 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

209 

(a) (a) (3 

@ (3 (a) 

(3 (3 (3 

PPP 

P (3 (3 

P @ (3 

P P P 

P P P 

P P P 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

225 

P (3) (a) 

(3 (3 (3 

@ (3 (3 

(3 (3 (3 

PPP 

PPP 

P P p 

P P P 

P P P 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 

241 

257 

(3) p P 

(3 (3 (3 

@(3 0 

® (3 @ 

(3 (3 (3 

P PP 

ppp 

p p P 

P P P 

PPP 

PPP 

ppp 

PPP 

PPP 

PPP 

PPP 

ppp 




3.5 TRANSFER FUNCTION 








The COPY command allows the user to perform record-for-record copying 
of tapes. 

Usage: 

COPY (CjuU^^ ,u 2 , tj 

where: "u^" is the source drive 

"U 2 " is the destination drive 

"t" may be an integer (number of records), "EOF", or "EOT" 

Standard parity and density (odd parity, 800 BPI) prevail, unless 
they have been changed by a FORMAT request. 


To copy an entire tape from unit 1 to unit 2, for example: 


REWINDulJ 

REWIND 

COPYl-jI, 2,EOTj 


To replace the last data record on unit 2 with the first data record 
on unit 1: 


REWIND^ 1J 
SPACE »™j2, EOT) 
BACKSPACE ui2,3 J 

COPYi—il, 2 , y 

TAPEMARKlj 2j 
TAPEMARK 2 J 


3.6 FILE MODIFICATION 

The file modification feature of MTDUMP allows the user to access 
single records, modify or delete words in a record, delete entire 
records, or add new records to his file. 


/find first record on 1. 

/find last record on 2. 

/backspace over two EOF's plus one data record, 
/copy 1 record from 1 to 2. 

/make a new EOT 
/ indicator on 2. 


3.6.1 Read a Single Record 

The next sequential physical record is read from tape unit u and is 
stored in core. Its length is saved in anticipation of a subsequent 
PUT request (see Paragraph 3.6.4). 


Usage: 

GET (G) uu^ 


At the completion of input, the following message is printed indicating 

S 97 



the length, in words, of the record just read. 


RECSIZE:nn 

3.6.2 Examine and Modify Data Words 

Designed for use in conjunction with the GET and PUT commands, the 
EXAMINE request allows the user to access and update individual data 
words in the program buffer. Any number of contiguous registers may 
be examined and modified with a single command. 

Usage: 

EXAMINE (E) u r^ 

where: "n" is the relative position in the buffer (record) of the 

first word to be displayed. If a "D" or "K" suffix (see section 3.2.4) 
is present, the argument is interpreted appropriately. If no suffix 
is present, "n" is interpreted according to the current global radix. 
The argument specifies the position of a word relative to word 0 in 
the buffer. 

Example: 

EXAMINE e_slj| 

The above command accesses the first data word in the buffer. The 
program responds to the command by displaying on the teleprinter the 
contents of the register specified in the mode (octal, symbolic, 
trimmed, ASCII) currently in effect. No carriage return is executed, 
however, after the displayed data word typeout. The user has 
several options. 

a. If a carriage-return is typed, the program responds 

by displaying the contents of the next higher register. 

b. If an ALTMODE is typed, buffer examination is 
deemed complete and the program returns to read a 
new command. 

c. A six-digit numeric string (octal notation) may be 
typed to replace the contents of the register being 
examined. The terminator of the line typed by the 
user may be either a carriage return or an ALTMODE . 

The terminator directs the program's activity after the 
desired modification has been performed. A carriage 
return opens the next sequential register; an ALTMODE 
returns control to the command processor. 




3.6.3 Specify Output Record Length 


The SIZE command specifies, in words, the length of the record to be 
written in response to a subsequent PUT request (see paragraph 3.6.4). 

Usage: 

SIZE n ) 

where: the parameter "n" is the total words in the output record. 

If a suffix "D" or "K" (see section 3.2.4) is present, the argument 
is evaluated appropriately. If no suffix is present, the numeric 
string is interpreted in the current global radix. 

Output record size is implicitly set during input "GET" processing. 

The SIZE facility offers a means of overriding the implicit setting. 

3.6.4 Write Single Record 

The PUT command writes data residing in the program’s buffer as the 
next sequential record on tape unit "u". The length of the record 
written is either the length of the record read in response to the 
latest GET request or the length specified in a SIZE request which 
occurred after the latest GET request. 

Usage: 

PUT (P) ^ u) 

3.7 DIRECTORY LISTING 

This group of commands is available for dealing with the Magnetic Tape 

File Directory. The contents of the Directory on unit "u" may he 
printed on the teleprinter or written into the Dump Output File; and 
the Directory may be cleared. None of these commands may be abbreviated 

3.7.1 Write File Directory in Dump Output File 

The contents of the File Directory of the tape specified are written 
in the Dump Output File. 

Usage: 

DDUMP ^ U ) 

3.7.2 Print File Directory on Teleprinter 

The contents of the File Directory of the tape specified are printed 
on the Teletype. • 




Usage: 


DLIST 


3.7.3 Clear Tape File Directory 

Write a new (empty) File Directory on the tape specified. 


Usage: 


NEWDIR tuJ u ) 




COMMAND. 


APPENDIX A 
SUMMARY OF COMMANDS 

MEANING 


PARAGRAPH # 


Setup Commands 


EXIT J 

FORMAT (F)i-jiU,pdcj 
FORMAT (F) U u, d 


Return Control to Monitor 
Set Non-Standard Tape 
Set Standard Tape 


LOGtjComment s j 

comments. \ 

(ALTMODE) 


mod: 


OCTAL A 

symbolic! 

TRIMMED j J 
ASCII J 


NUMBER^ 


OCTAL \ . 
DECIMALJ V 


Insert one or more lines of 
comments 


Dump File Display 


Specify Global Radix 


3.2.8 

3.2.1 

3.2.2 
3.2.7 


3.2.6 

3.2.3 


NOTE 

D (decimal) or K (octal) specifies Local Radix 
which overrides Global Radix during processing 
of a single command line. 


VERIFY 



Bypass Command-Line 


3.2.5 


Manipulative Commands 


BACKSPACE (B) «__ju , t j 

Backspace Tape 

3.3.2 

REWIND (R) a_jU J 

Rewind Tape 

3.3.1 

SPACE (S) uU,tj 

Space Tape 

3.3.3 

TAPEMARK(T) s _ J u^ 

Write End-of-File Marker 

3.3.4 



Dump File Commands 


CLOSEj 

Close Dump Output File 

3.4.1 

DUMP (D) fuju,tj 

Dump Records into Named File 

3.4.2 

LIST (L) L_jU,t^ 

Dump Records onto teleprinter 

3.4.3 

OPEN uf ilenameuextj 

Open Named File 

3.4.1 




APPENDIX A (Cont.) 


COMMAND 

MEANING 

PARAGRAPH 


Transfer Cohmmq. 


COPY(C) u 

,u 2 ,t Copy Tape Specified 

3.5 


Ftif Modification Commands 


EXAMINE(E) 

n Examine and Modify Data Words 

3.6.2 

GET(G) u 

Read Single Record 

3.6.1 

PUT (P) u 

Write Single Record 

3.6.4 

SIZE n 

Specify Output Record Length 

3.6.3 


Directory Commands. 


DDUMP u 

Write File Directory in Dump 
Output File 

3.7.1 

DLIST u 

Print File Directory on Tele¬ 
printer 

3.7.2 

NEWDIR u 

Clear Tape File Directory 

3.7.3 


A 
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Telephone (415)-884-6200 Datsphone 41S8S4-1433 

Oakland 

7850 Edgewater Drive. Oakland. California &4S2J 
Telephone. (4l5)-63S-5453/78a> Dataphone- 415-582-21$) 
West Los Angeles 

1510 Cctnor Avenue. Los Angeles. California 90025 

Telephone (213)-479-3791/43l8 Dataphona- 213-4785328 

COLORADO 

7301 E. Bellevue Avem/s 

Suite 5. Englewood. Coioredo 60110 

Telephone {3O3)-77O-6150 Datsphone 303-7700328 

NEW MEXICO 
Albuquerque 

10200 Manual N E . Albuquerque. New Mexico 87112 
Telephone (505)-293-54 11 /5428 Dataphone 505-294-2330 

OREGON 
Port lend 
Suite 163 

5319 S.W. Weatgote Drive. Portland. Oregon 97221 
Telephone: (503)-297-3781 /3765 

UTAH 

Salt Lake City 

429 Lawn Dale Drive. Salt Lake City. Utah 84115 
Telephone (601)-487-4f®9 Dataphone E01-467-0535 

WASHINGTON 

Bollevoa 

13401 N.E. Bellevue. Redmond Rood. Suita 111 
Bellevue. Washington 

Telephone (20S)-S«5-4QS8/455-54M Dataphone 203-747 3754 


INTERNATIONAL 


EUROPEAN HEADQUARTERS 

Digital Equipment Corporation International Europe 

81 route da I Aire 

1211 Geneva 26. Switzerland 

Telephone 42 79 50 Telex: 22 683 

FRANCE 

Digital Equipment France 

Centre Silic — C'dex L 225 

94533 Rungis. France 

Telephone 687 23 33 Telex 26840 

GRENOBLE 

Digital Equipment France 

Tour Mangin 

16 Rue Du Gal Mangin 

38100 Grenoble. France 

Telephone (76)07 56-01 Telex 212-32632 

G ERMm FEDERAL BEFUBUC 

Digital Equipment GmbH 
MUNICH 

8 Muenchen 13. Wallonsteinpletx 2 
Telephone 0811-35031 Telex: 524-228 
COLOGNE 

5 Koeln 41. Aachener Strasse 311 

Telephone 0221-44-40-95 Telex 688-2269 

Telegram Flip Chip Koein 

FRANKFURT 

SO78 Neu-lsenburg 2 

Am Foroloua Grsvebruch 5-7 

Telephone 06102-5528 Telox: 4176-82 

HANNOVER 

3 Hannover, Podbielakistrasse 102 
Telephone- 0511-69-70-95 Telex: S22-6S2 
STUTTGART 

D-7S)1 Kemnat. Stuttgart 
Merco-Polo-Strasse 1 

Telephone (0771)45-50-65 Tele* 841-722-393 

AUSratA 

Digital Eqoipment Corporation Goa m.b.H 
VIENNA 

MenshiJferstrasse 133. 1150 Vienna 15. Austria 
Telephone 65 51 ^ 

UWfTED KMGOOM 

Digital Equipment Co. Ltd 

U K HEADQUARTERS 

Fountain House. Butts Centre 

Reading RGl 7QN, Engl&rvd 

Telephone (0734>-^3555 Tslex 8^3278 

BIRMINGHAM 

Money Buddings 

29/31 Birmingham Rd . Sutton Coldfield 
Warwickshire. England 
Telephone O21-355-SS0? Telex 337-C m 
BRISTOL 

Fish Ponds Roed. Fiah Ponds 
Bristol. England BS183HQ 
Telephone Bristol 651-431 
EALING 

Billon House. Uxbridge Roed. Ealing, London W 5 
Telephone 01-579-2334 Tolox- 22371 
EDINBURGH 

Shiol House. Craigehtll, Livingston. 

Wgst Lothian. Scotland 
(Tetephona 32705 Teloa 727113 
LONDON 

Manogomant House 

43 Parker St . Holborn. London 
WC 3B 5PT. England 

Totepbona 01^B-2S14/^®7 Tolas 275S0 

MANCHESTER 

Amdsl© House 

Chester Road Slrotford. Manchaeter M32 
T®J©#ions (031)^5-70} 1 Toloa mmm 


uwrrgD ttmGDOM {com.) 

READING 

Fountain House. Butts Centre 

Reading RGl 7QN. England 

Telephone (0734)-583SS5 Telex 8483278 

NETHERLANDS 

Digital Equipment N.V 
THE HAGUE 

Sir Winston Churchlllion 370 
Rijawijk/The Hague. Netherlonde 
Tolephon®: 94 9220 Telex 35533 

BELGIUM 

Digital Equipment NV /S.A. 

BRUSSELS 

103 Ruo D'Arhsn 

1040 Brussels. Belgium 

Telephone 02-1B25S Telex: 25297 

SWEDEN 

Digital Equipment AB 

STOCKHOLM 

Englundavagen 7. 171 41 Soine. Sweden 
Telephono ^ 13 SO Telex: 170 50 
Cable Digital Stockholm 

NORWAY 

Digital Equipment Corp. A/S 
OSLO 

Trondhoimsveion 47 
Oslo 5, Norway 

Telephone 02/68 34 40 Teles 1S079 DEC N 

DENMARK 

Digital Equipment Aktieboleg 
COPENHAGEN 
Heilerupveg 63 
2900 Hellerup. Denmark 

FINLAND 

Digital Equipment AB 
HELSINKI 
Tiliemaantie G 
SF-00710 Helsinki 71 
Telephone: (G33) 370133 
Cable Digital Hsleinki 

SWfTZERLAra 

Digital Equipment Corporation S A. 

GENEVA 

20. Quei Ernest Aneermet 

Boite Postals 23. 1211 Genova 8. Switzerland 

Telephone No 022*20 ^5 20 and 20 58 93 and 20 68 93 

Telex 20 92 01 

ZURICH 

Digital Equipment Corp AG 
SchaHheusorstr 315 
CH 6050 Zurich. Switzerland 
Telephone 01-43-41-91 Telex S50S9 

STALY 

Digital Equipment S p A 
MILAN 

Corgo Geribstdi ^3121 Mileno. Italy 
Telephone fS2H?5MB1/2/3/4/5 Telex: g^-^lS 

Digital Equipment CcrpoTsttcn Ud. 

MADRID 

Ataio Ingsnieros S.A., Ennquo Lemsts 12. h^rld li 
Telsphono. 215 S 43 Tolea 27t4© 

BARCELONA 

Ataio Jngemeros S A,, Granduaar 78. SsresJofsa 6 
Telsphono- 221 44 ^ 


ISRAEL 

DEC Systems Computero Ltd. 

TEL AVIV 

Suite 103, Southern Hab&kuk Street 
Tel Aviv. Israel 

Telephone (03) 443114/440763 Telex 9K-33-3163 


CANADA 

Digital Equipment of Canada. Ltd 
CANADIAN HEADQUARTERS 
P O Boa 11500 
Ottawa. Ontono. Canado 
K2H B&8 

Telephowe (013)-592 5111 TWX 610-SS-87S 
TORONTO 

2550 Goldenridge Rood. Mlaaieoeuga. Ontario 

Telephone (416)-270-9400 TWK 610-^2-7118 

MONTREAL 

SK5 Cota Da Lioeae 

Dorval. Quebec, Canada K9P 2M9 

Telephone (514)-6^-9393 Telex 610-422-4124 

CALGARY/Edmonton 

Suit© 140. 6§30 Fishar Road S E 

Calgary. Albarta. Canada 

Telephone (403)435-4281 TWX 403-2^-7 488 

VANCOUVER 

Suit© 202 

644SW Marins Dr . Vancouver 

British Columbia. Canada VfiP 5Y1 
Telephone (604)-325-3231 Telex 610-929-2003 

GENERAL INTERNATIONAL SALES 

REGIONAL OFFICE 

1^ M&in Street. Msyn&rd. Massechuoatt© 01754 
Telephone (017) 897-5111 

From Metropolitan Boston. &S3-©3K) 

TWX 710-347-0817/0212 
Csbto DIGITAL MAYN 
Telex 94-8457 

AUSTRALIA 

Digital Equipment Australia Pty Ltd 
ADELAIDE 

6 Montrose Avenue 

Norwood. South Australis 5057 

Telephone (03)42-1339 Teles 790-82825 

BRISBANE 

133 Leichherdl Street 

Spring Hill 

Brisbane. Queensland. Australia <5803 
Telephone (072)233068 Telex 7§0^OSI§ 

CANBERRA 
27 Colhe St. 

Fyshwick. A.C T 2£09 Australia 
Telephone (082) 953073 
MELBOURNE 

S3 Park Street. South Melbourne. Victoria 3205 
Australis 

Telephone (03}-6S9-28S3 Telex 790-30700 

PERTH 

643 Murray Street 

West Perth. Western Austral is 

Telephone (G32>-21 4§93 Telex 735-92140 

SYDNEY 

P O Boa . Crows Nest 

NSW Australia 2CS5 

Tolaphrmo {O2)-<330-2SSS Tele# 7S>S0?«O 

Digital Eetuipmant Cerpomtion Ltd. 

AUCKLmD 

Hilton Hshjbs. 4^) Queen Street. Boa 347S 
Auckland. Now Zealand 
T©l©ph©s«: 75533 


mvm 

Digital Equipment Corporation International 
Kows Building No 16— Annex. Flrot Floor 
9-20 Akasaka 1-Chome 
Mmoto-Ku. Tokyo 107. Japan 
Telephone 566-2771 Tslox J-2S428 
Rikei Trading Co . Ltd (aeies only) 

Kozato-Kaikan Bldg 
No 16-14 Nishiahimbaahi 1-Chome 
Mmato-Ku. Tokyo. Japan 
Telephone 5915248 Telex 701-4203 

PUERTO RICO 

Digital Equipment Corporation Do Puerto Rico 

407 dal Psrque Street 

Santurce. Puerto Rico 01312 

Telephone (809) 723-8058/67 Telex 385-90SB 

ARGENTINA 
BUENOS AIRES 
Cossin S-A 

Virroy del Pino. 407\. Buenos Alreo 
Telephone 52-31BS Telex 012-2234 

BRA^L 

RIO DE JANEIRO — GB 
Ambries S A 

Rub Cewfl. 104. 2c 3 ©ndsres ZC - 29 
Rio Da Janeiro — GB 
Telephone 2S4-7<S03/CW81 /7S3S 

SAO PAULO 

Ambries S.A 

Rue Tupl. 535 

Sso Paulo —- SP 

Tolephone 52-78^/1870. 51-0912 

PORTO ALEGRE — RS 

Rus Coronol Vicente 421/101 

Porto Alegre — RS 

Telephone 24-7411 

CHILE 

SANTIAGO 

Coasin Chile Ltde (aalea only) 

Cssilla 14^3. Correo 15. 

Telephone 3S8713 Cable COACHIL 

INDIA 

BOMBAY 

Hmditrcn Computers Pvt. Ltd. 

®/A, L Jegmohendas Merg. 

Bombsy-6 (W0) Indie 

Telephone ^-1015 3-5344 Telex: 011-25S4 Plenty 
Cable TEKHIND 

mmeo 

MEXICO CITY 
Msaitek. S A 
Eugenie 408 Deptoa 1 
Apdo Postal 12-1012 
Mexico 12. D F 
Telephone (SOS) 5®-®-10 

TOIUTOMES 

MANILA 

Stanford Computer Corpwetion 
P O. Box 1639 
416 Desmprmas St. Manila 
Telephone ^)-€3-98 Telex- 742-0352 

VENEZUELA 
CARACAS 
Cossin. C.A 
Apert edo a®® 

Sabena Grande No. 1. Caracas ICS 
Telephone 72-^^2. 72*^37 
Cable INSTRUVEN 








SOFTWARE PROBLEMS OR ENHANCEMENTS 


Questions, problems, end enh.ncement. to Digital software should be reported on a software Performance 
Report tSPR) form and mailed to the SPR Center at one of the following Digital Offloesi (SPR forms 
available from the SPR Center.) 


Areas Covered 


SPR Center 


Australia/New Zealand Digital Equipment Australia Pty. Ltd. 

123-125 Willoughby Road, P.O. Box 491 
Crows Nest 

New South Wales, Australia 2065 


Digital Equipment Comercio E Industria LTDA 
Rua Batatais, 429 (Esq. Al. Campinas) 
01423-Jardim Paulista 
Sao Paulo-SP-Brazil 


Canada 


Caribbean 


Digital Equipment of Canada, Ltd. 
Software Services 
P.O. Box 11500, K2H 8K8 
Ottawa, Ontario, Canada 

Digital Equipment Latin America, Inc. 
407 del Parque Street 
Santurce, Puerto Rico 00912 


United States, Far East, 
Middle East, Africa, 
Remainder of Latin America 


Software Communications 
p.o. Box F 
Maynard, MA 01754 


Digital Equipment France 
18, rue Saarinen 
Centre Silic - CIDEX L225 
F-94533 Rungis, France 


Israel 


Italy 


Japan 


Mexico 


The Netherlands 
Belgium 


DEC-sys Computers Ltd. 

7 Habakuk Street 
IL-Tel Aviv 63505, Israel 

Digital Equipment S.P.A. 

Corso Garibaldi 49 
1-20121 Milano, Italy 

Digital Equipment Corp. Int. 

Kowa Building #25 (3rd Floor) 

8-7 Sunban-Cho 

Chiyoda-ku, Tokyo 102, Japan 

Equipo Digital, S.A. de C.V. 

109 Concepcion Beistegui 
Mexico 12, D.F. 

Digital Equipment B.V. 

Kaap Hoorndreef 38, P.O. Box 9064 
NL-Utrecht - Overvec'nt, The Netherlands 


Scandinavia 


Digital Equipment AB 
Englundavagen 7 
S-17141 Solna 
Sweden 


Switzerland 
Spain Portugal 

Greece Bulgaria 

Romania Yugoslavia 


Digital Equipment Corp. SA 

20, Quai Ernest Ansermet 

Case Postale 23, CH-1211 Geneva 8 

Switzerland 


United Kingdom 


West Germany Austria 

East Germany Russia 

Hungary Poland 

Czechoslovakia 


Digital Equipment Co. Ltd. 
Fountain House, Butts Centre 
GB-Reading RG1 7QN, England 

Digital Equipment GmbH 
D-8000 Munchen 40 

Wallensteinplatz 2 
West Germany 



HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance.Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software,^programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published period!” 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to; 

Software Communications 
P. 0. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital’s software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS, Digital Equipment Computer Users Society, maintains.a user ex¬ 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS 

Digital Equipment, S.A. 
P.O. Box 340 
1211 Geneva 26 
Switzerland 







DIGITAL'S REGIONAL EDUCATION CENTERS 
For information regarding DIGITAL'S Customer Training Program 

AND TO ACCOMODATE COURSE ENROLLMENTS, CONTACT YOUR NEAREST 

Education Center listed below: 


PHILADELPHIA AREA: 

Digital Equipment Corporation 

Educational Services Department 

Whitpain Office Campus 

1740 Walton Road 

Blue Bell, Pennsylvania 19422 

Telephone: (215)825-4200 Ext.24 

WASHINGTON, D.C. AREA: 

Digital Equipment Corporation 
Educational Services Department 
Lanham 30 Office Building 
5900 Princess Garden Parkway 
Lanham, Maryland 20801 
Telephone: (301)45-7900 

BOSTON AREA: 

Digital Equipment Corporation 
Educational Services Department 
(PDP-10 8 PDP-15) 

200 Forest Street 

Marlboro, Massachusetts 01752 

Telephone: (617)481-9511 Ext.5071 

Digital Equipment Corporation 
Educational Services Department 
Maynard, Massachusetts 01754 
Telephone: (617)89705111 Ext:. 3819 

or 2564 


PRINCETON, N.J. AREA: 

Digital Equipment Corporation 
Educational Services Department 
U.S. Route 1 r- 

Princeton, New Jersey 08540 
Telephone: (609)452-2940 


CHICAGO AREA: 

Digital Equipment Corporation 
Educational Services Department 
5600 Apollo Drive 
Rolling Meadows, Illinois 60008 
Telephone: (312)640-5500 


SAN FRANCISCO AREA: 

Digital Equipment Corporation 
Educational Services Department 
310 Soquel Way 

Sunnyvale, California 94086 
Telephone: (408)735-9200 Ext.221 


f 





UNITED KINGDOM: 

Digital Equipment Company Ltd. 
Fountain House, Butts Center 
Reading, England RG1,70N 
Telephone: 58-35-55 


GERMANY: 

Digital Equipment Gmbh. 
Educational Services Department 
Wallensteinplatz 2 
D-8 Munich 13,Germany 
Telephone: 35-03 1 


THE NETHERLANDS: 

Digital Equipment N.V. 
Educational Services Department 
Kaap Hoorndrief 38 
Utrecht, Holland 
Telephone: 030-63 12 22 


SWEDEN: 

Digital Equipment AB 
Englundavaegen 7,3TR 
S-171-41 Solna, Sweden 
Telephone: 08/98-13/90 


FRANCE: 

Digital Equipment S.A.R.L. 
Educational Services Department 
2 Place Gustave Eiffel 
F-94533 Rungis, France 
Telephone: (01)687-2333 


ITALY: , 

Digital Equipment SPA 
Educational Services Departing 
Corso Garibaldi 49 
1-20121 Milan, Italy 
Telephone: 87-90-51 ^ 

AUSTRALIA: 

Digital Equipment Australia 

Pty. Ltd. 

Educational Services Departm 
123-135 Willoughby Road 
Crows Nest 

New South Wales 2065, Australia 
Telephone: 439-2566 


JAPAN: 

Digital Equipment Corporation 

Ltd 

Educational Services Department 
Kowa Bldg. No.25, Third Floor 
8-7 Sanban-Cho 

Chiyoda-ku, Tokyo 102, Japan 
Telephone: (03)264-7101 



THE FOLLOWING PAGES ARE MISSING 


10-12 

14-17 

21-25 

112-117 

o 179-180 

203-204 
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DIGITAL EQUIPMENT CORPORATION, Maynard, Massachusetts, Telephone: (617) 897-5111 • ARIZONA, Phoenix • CALIFORNIA, 
Sunnyvale. Santa Ana. Los Angeles. San Diego and San Francisco (Mountain View) • COLORADO. Engelwood • CONNECTICUT. 
Meriden • DISTRICT OF COLUMBIA. Washington (Riverdale, Md.) • FLORIDA. Orlando • GEORGIA. Atlanta • ILLINOIS, Northbrook 
• INDIANA. Indianapolis • LOUISIANA. Metairie • MARYLAND. Riverdale • MASSACHUSETTS. Cambridge and Waltham • MICHIGAN, 
Ann Arbor and Detroit (Southfield) • MINNESOTA. Minneapolis • MISSOURI. Kansas City and Maryland Heights • NEW JERSEY, 
Fairfield. Metuchen and Princeton • NEW MEXICO. Albuquerque • NEW YORK. Huntington Station. Manhattan, New York, Syracuse 
and Rochester • NORTH CAROLINA. Durham/Chapel Hill • OHIO. Cleveland. Dayton and Euclid • OKLAHOMA, Tulsa • OREGON, 
Portland • PENNSYLVANIA, Bluebell. Paoli and Pittsburgh • TENNESSEE. Knoxville • TEXAS. Dallas and Houston • UTAH. Salt Lake 
City • WASHINGTON. Bellevue • WISCONSIN. Milwaukee • ARGENTINA. Buenos Aires • AUSTRALIA. Adelaide. Brisbane, Crows 
Nest. Melbourne. Norwood. Perth and Sydney • AUSTRIA. Vienna • BELGIUM, Brussels • BRAZIL. Rio de Janeiro. Sao Paulo 
and Porto Alegre • CANADA. Alberta. Vancouver. British Columbia; Hamilton, Mississauga and Ottawa. Ontario; and 
Quebec • CHILE, Santiago • DENMARK, Copenhagen and Hellerup • FINLAND. Helsinki • FRANCE. Grenoble and Rungis • 
GERMANY. Cologne. Hannover. Frankfurt. Munich and Stuttgart • INDIA. Bombay • ISRAEL, Tel Aviv • ITALY, Milano • JAPAN. 
Osaka and Tokyo • MEXICO. Mexico City • NETHERLANDS. The Hague • NEW ZEALAND. Auckland • NORWAY, Oslo • 
PHILIPPINES. Manila • PUERTO RICO, Miramar and Santurce • REPUBLIC OF CHINA, Taiwan • SCOTLAND, West Lothian • 
SPAIN, Barcelona and Madrid • SWEDEN, Solna and Stockholm • SWITZERLAND, Geneva and Zurich • UNITED 
KINGDOM. Birmingham, Bristol. Edinburgh, London, Manchester, Reading and Warwickshire • VENEZUELA, Caracas 






